Model Context Protocol

Connect Your AI Tools to RetrieveIt

Use MCP to let AI assistants like Claude, ChatGPT, and other tools search your knowledge base, list workspaces, and query documents.

Two Ways to Connect

Choose the method that fits your AI tool.

API Key (Bearer Token)

Generate a key in the app and paste it into your tool's MCP configuration. Full access to all tools.

Claude DesktopClaude CodeCursorWindsurfCustom Clients

OAuth 2.0

Click "Connect" and authorize through the browser. No configuration needed. Scoped permissions.

Claude.aiChatGPTWeb Platforms
Option 1

API Key Setup

For desktop and CLI tools where you configure the MCP server manually.

1

Generate an API Key

  1. Log in to app.retrieveit.ai
  2. Navigate to the MCP tab in your dashboard
  3. Click Generate API Key
  4. Copy the key immediately — it is only shown once

Key format: rai_ followed by 40 characters. If you lose it, generate a new one.

2

Add to Your AI Tool

Add the following MCP server configuration to your AI tool. Refer to your tool's documentation for where MCP servers are configured.

MCP Configuration
{
  "mcpServers": {
    "retrieveit": {
      "url": "https://api.app.retrieveit.ai/mcp/v1",
      "headers": {
        "Authorization": "Bearer rai_your_api_key_here"
      }
    }
  }
}

Replace rai_your_api_key_here with your generated key. Restart the tool after saving.

Option 2

OAuth Setup

For web-based AI platforms that support OAuth. No manual configuration required.

Claude.ai

  1. 1In Claude.ai, open integrations and select RetrieveIt.AI
  2. 2You'll be redirected to RetrieveIt.AI to log in
  3. 3Review the requested permissions and click Allow
  4. 4You're redirected back — the connection is active

ChatGPT

ChatGPT can connect via a GPT Action using RetrieveIt.AI's OpenAPI spec. The authorization flow works the same way — you'll be redirected to approve access.

OAuth Scopes

OAuth connections request specific permissions. You'll see these on the consent screen:

read:workspacesView your list of workspaces
read:documentsList documents within workspaces
searchQuery the knowledge base with semantic search

Managing Connected Apps

You can review and revoke OAuth connections at any time from Settings → Connected Apps in RetrieveIt.AI. Revoking immediately invalidates all tokens for that app.

Token lifetimes: Access tokens expire after 1 hour (refreshed automatically). Refresh tokens are valid for 90 days and rotate on each use.

Available Tools

Once connected, your AI assistant can use these tools.

list_workspaces

read:workspaces

List all workspaces the authenticated user has access to.

Returns: Workspace name, description, and status.

list_workspace_documents

read:documents

List documents in a specific workspace with pagination support.

Returns: Document name, path, size, and last modified date.

query_knowledge_base

search

Perform semantic search across your workspace documents using natural language.

Returns: Ranked results with content, source reference, and relevance score.

Endpoint Reference

URLhttps://api.app.retrieveit.ai/mcp/v1
MethodPOST
ProtocolJSON-RPC 2.0 over HTTP
AuthAuthorization: Bearer with API key or OAuth token

MCP Methods

initializeHandshake — returns server capabilities
tools/listList available tools and their schemas
tools/callExecute a tool with parameters

Ready to Connect?

Generate your API key or connect through your AI platform to start searching your knowledge base.

Open RetrieveIt.AILearn About MCP