Docs
Help Center

Connecting Your Tools

Connect Cursor, Claude Code, OpenAI Agent Builder, n8n, or a custom client to Guru's MCP server.

This page shows you how to connect development tools to Guru's MCP server. For authentication options and background, see Authentication & Connection Setup.

Cursor IDE

  1. In Settings > Cursor Settings > Tools & MCP, click "New MCP Server".
  2. Add Guru's MCP server to the mcp.json file, then save and close it.
{
  "mcpServers": {
    "Guru": {
      "url": "https://mcp.api.getguru.com/mcp"
    }
  }
}
  1. Under Installed MCP Servers, click "Connect" next to the Guru MCP server you just installed.
  2. Grant permissions for Cursor to access Guru via MCP.

Claude Code

  1. After installing Claude Code, open a terminal window.
  2. Run claude mcp add --transport http guru https://mcp.api.getguru.com/mcp to install Guru's MCP server.
  3. Run claude mcp list to confirm Guru MCP is included. You'll see that the server still needs authentication.
  4. Open Claude Code by running claude.
  5. Type /mcp to manage your MCP servers, navigate to the one you just created for Guru, and press Enter.
  6. Choose Authenticate. A browser window opens where you accept the necessary permissions.

OpenAI Agent Builder

  1. Open your agent in Agent Builder and click the + next to Tools, then choose MCP Server. Alternatively, open your MCP node and click + Add.
  2. Click + Server at the top right to add a new MCP server.
  3. In your terminal, base64 encode your Guru email address and API token. Do not include the curly brackets. You'll use the output in the next step.
echo -n "{email}:{api_token}" | base64

  1. Fill out the following fields:

    • URL: https://mcp.api.getguru.com/mcp
    • Label: guru_mcp_server
    • Description: Guru MCP Server
    • Authentication: Custom headers
      • header: Authorization
      • value: Basic {output_from_step_3}

  2. Click Connect to establish the connection to Guru's MCP server.

  3. Select the Guru tools you'd like your agent to have access to.

  4. Click Add.

n8n

Configure a credential

  1. From the "Overview" page, click "Credentials", then Create credential.
  2. Select MCP OAuth2 API, then click "Continue".
  3. Ensure "Use Dynamic Client Registration" is set to true, then enter https://mcp.api.getguru.com/mcp as the Server URL.
  4. Click "Connect my account". An authorization screen opens in Guru where you accept permissions.
❗️

If authentication fails with a scope error

You may see Authentication failed: The 'scope' parameter is invalid, the supported scope is 'default' during step 4. This is an intermittent n8n bug. Copy the URL from the authentication screen, paste it into a new tab, change scope=openid to scope=default at the end of the URL, and press Enter. This bypasses the error and brings you to the screen where you accept permissions.

Configure the MCP Client node

  1. Choose the MCP Client node and enter https://mcp.api.getguru.com/mcp as the MCP Endpoint URL.
  2. Select MCP OAuth2 from the "Authentication" dropdown.
  3. Select the credential you just created for the "Credential for MCP OAuth2 API" option.
  4. Select the tool to use in your workflow. Some tools require an agentId. You can find the agentId in Guru on the API tab of the Knowledge Agent you'd like to use.

Custom MCP client

If you're building your own MCP-compatible app:

  • Use the MCP client SDK in your language of choice.
  • Configure Guru's endpoint: https://mcp.api.getguru.com/mcp
  • Provide your credentials (OAuth or token).
  • The SDK handles all protocol communication automatically.

Updated 17 days ago