Troubleshoot and manage Vani MCP

Troubleshoot and manage Vani MCP

Claude says it cannot reach the MCP server

  1. Check that you entered the correct Vani MCP server URL and that it ends with /mcp. Example: https://app.vanihq.com/mcp.
  2. Do not use a private, local, staging, or VPN-only URL unless Vani support has asked you to test one. Claude custom connectors connect from Claude's cloud infrastructure, so the MCP server must be reachable over the public internet.

The sign-in window does not open

  1. Disconnect and reconnect the Vani connector from Claude settings.
  2. If your browser blocks pop-ups or redirects, allow them for Claude and Vani, then try again.

I signed in, but Claude still cannot use Vani tools

  1. Make sure the Vani connector is enabled in the current Claude conversation. Adding a connector and enabling it in a chat can be separate steps.
  2. Check that your Vani account has access to the team, Space, Zone, or action you're asking about.

Claude says "permission denied" or "access denied"

Your Vani role may not allow that action. Ask a Vani admin or a Space organizer for the required access, or ask the assistant to perform a read-only task instead.

Claude keeps asking you to reconnect

Remove the Vani connector from Claude and add it again using the correct Vani MCP server URL. This starts a fresh secure sign-in flow.

You connected to the wrong Vani data center

Remove the connector and add it again using the correct regional URL. Your Vani account and data must be in the same data center as the MCP server URL.

Information to send Vani support

If the problem continues, contact Vani support (support@vanihq.com) with:
  1. Your Vani data center or app domain.
  2. The approximate time of the failed connection.
  3. The exact error shown in Claude.
  4. Whether you are using Claude Free, Pro, Max, Team, or Enterprise.
  5. Whether you are setting up a personal connector or an organization connector.
Warning
Do not send passwords, access tokens, refresh tokens, authorization codes, or browser cookies.

Next steps

    • Related Articles

    • Vani MCP basics

      What is Vani MCP Vani MCP lets supported AI assistants and MCP clients connect securely to your Vani workspace, understand your projects and documents, and help you perform actions in Vani from a conversation. MCP stands for Model Context Protocol. ...

    • Use Vani MCP in Claude

      Get started After setup, enable the Vani connector in a Claude conversation, then ask Claude for help with Vani work. Example prompts: Find Vani Spaces about Q4 launch planning and summarize what each Space contains. Search my team for comments ...

    • Set up Vani MCP in Claude

      Before you begin You need: A Vani account. Access to the Vani team, Space, or Zone you want the AI assistant to work with. A Claude plan that supports connectors. The Vani MCP server URL for your Vani data center (see below). Vani MCP server URLs Use ...

    • Frequently asked questions

      Does Claude get my Vani password? No, sign-in happens through Vani and Zoho Accounts using OAuth. Claude receives permission to call Vani MCP tools after you approve access, but it does not receive your password. Can a connected AI assistant see all ...

    • Manage Guest Users and Permissions in Vani

      Guest users in Vani allow you to collaborate with people who are not regular members of your organization. You can add users as guests from Org settings and then give them access to specific Spaces when needed. Guest access helps you work with ...