Connections for Developers

Cursor IDE

1. In Settings → Cursor Settings → Tools & MCP, click “New MCP Server”
2. Add Guru's MCP to the mcp.json file and save the file and close it

{
  "mcpServers": {
    "Guru": {
      "url": "https://mcp.api.getguru.com/mcp"
    }
  }
}

3. Under Installed MCP Servers, click "Connect" next to the Guru MCP you just installed
4. Grant permissions for Cursor to access Guru via MCP

Claude Code

1. After installing Claude Code, open a terminal window to interact with Claude CLI
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 view all installed MCP servers and make sure Guru MCP is included. You'll see that the MCP server still needs authentication
4. To authenticate, open Claude Code by executing claude
5. Once you're in Claude Code, type /mcp to manage your MCP servers. Navigate the the one you just created for Guru and click Enter
6. Choose Authenticate. This will open a browser window where you'll be prompted to 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. The output here will be used in step 4.

echo -n "{email}:{api_token}" | base64

4. 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}
   

5. Click Connect - this will establish the connection to Guru's MCP server
6. Select the Guru tools you'd like your agent to have access to
7. Click Add

n8n

Configure 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/mcpas the Server URL
4. Click "Connect my account" - this will bring up an authorization screen in Guru where you'll need to accept permissions.

❗️

Note: You may receive the following error during Step 4: Authentication failed: The 'scope' parameter is invalid, the supported scope is 'default'. This is due to an intermittent bug with n8n. If you encounter this error, simply copy the URL from the authentication screen, open a new tab and paste it in. At the end of the URL, change scope=openid to scope=default, and hit enter. This should bypass the error and bring you to the correct screen where you'll accept permissions.

Configure MCP Client Node

5. Now you are ready to use Guru's MCP server in your n8n workflow. Choose the MCP Client node and enter https://mcp.api.getguru.com/mcp as the MCP Endpoint URL.
6. Select MCP OAuth2 from the "Authentication" dropdown
7. Select the credential you just created for the "Credential for MCP OAuth2 API" option.
8. You can then select the tool you'd like to use in your workflow. Some tools require an agentId to be passed in. 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