Skip to main content
Connect a Claude client to the Operata MCP Server so Claude can query your real Operata data. Ask “how many traces in the last 30 days” and Claude answers from your account. OAuth is the recommended way to connect. Use an API key only for automated, non-interactive integrations. For the difference, roles, and prerequisites, see the MCP overview.

​
Before you start

  • An Operata account. For OAuth, a user with the Admin or User role; for an API key, an Operata API key. See Before you start.
  • Claude Desktop, Claude Code, or the Claude API, installed and signed in.

​
Connect over OAuth

​
Claude Desktop

Open the Claude Desktop configuration file:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
Add the Operata MCP server to the mcpServers object:
claude_desktop_config.json
Restart Claude Desktop. On first use, a browser window opens to sign in to Operata and authorize the session.

​
Claude Code

Register the server against the OAuth endpoint:
Run /mcp inside Claude Code and follow the prompt to authenticate. Use /mcp again at any time to reconnect or re-authenticate.

​
Claude API

Pass the Operata MCP server in the mcp_servers field of the request body. See Anthropic’s MCP connector documentation for the request shape.

​
Connect with an API key

Use the API key endpoint for automated integrations. The key can only reach the single group it was created in.

​
Claude Desktop

claude_desktop_config.json
Replace <your-operata-api-key> with your key, then restart Claude Desktop.

​
Claude Code

​
Select a group

On an OAuth session, pick the group you want to query: run list_groups, then switch_group. An API-key session is already fixed to its own group. See Groups and regions.

​
Ask Claude a question that uses Operata data

Start a new conversation and ask something that needs Operata data:
How many traces have been recorded in my Operata account in the last 30 days?
Claude calls the right Operata tool — traces_query for an aggregate like this, or knowledge for a concept question — and cites the tool call in its response.

​
Result

Claude lists operata under available tools. A question that needs Operata data triggers a tool call and returns a real number from your account, not a placeholder. A 401 in the tool-call trace means the credential is wrong or expired; a 403 means a group problem. See Troubleshooting.