Authentication & Connection Setup

Connecting an MCP client to Guru takes one of two authentication paths: OAuth for user-facing AI assistants, or an API token for backend scripts and automation.

Option 1: OAuth (recommended)

Best for AI assistants and user-facing integrations such as ChatGPT, Claude, and Cursor.

1. Open your AI tool's MCP connection settings.
2. Add a new connection with the Guru MCP URL: https://mcp.api.getguru.com/mcp
3. Select OAuth and sign in with your Guru credentials.
4. Approve the access request.

The client now interacts with Guru using your account's permissions, and Guru appears as a connected service in your AI client's settings.

Option 2: API token

Best for backend scripts and automation systems.

1. In Guru, go to Admin > API Tokens and generate a token tied to your user or service account.
2. When prompted by your MCP client, provide your user email, the API token, and the MCP URL: https://mcp.api.getguru.com/mcp

Access control

• The Guru MCP server enforces the same role-based permissions as Guru's web app.
• Each query only returns knowledge that the authenticated user can access.
• All interactions are logged in Guru's AI Agent Center for visibility and governance.

To learn more, see Connecting Guru's MCP Server in the Help Center.