Claude Integration

Claude supports MCP natively in both Claude Desktop and Claude Code. This guide covers setup for each.

Claude Desktop

Claude Desktop supports remote MCP connectors with browser-based authentication. Add Datatape through Claude's connector settings; the desktop configuration file is for local extensions and is not the current setup path for remote servers.

Setup

1. Open Settings → Connectors in Claude Desktop.
2. Choose Add custom connector.
3. Enter a name and your Datatape endpoint: https://<org-id>.mcp.datatape.ai/mcp.
4. Connect, then complete authentication in the browser.
5. After authentication, the tools assigned to you appear in Claude.

OAuth Flow

When Claude Desktop connects for the first time:

1. Claude discovers OAuth metadata from the /.well-known/ endpoints
2. Your browser opens to the configured identity provider
3. After sign-in, Claude receives tokens and loads your tools
4. Claude handles token refresh

Claude Code

Claude Code (the CLI) also supports MCP servers. Add your Datatape endpoint with a single command.

Setup with OAuth

claude mcp add --transport http datatape https://<org-id>.mcp.datatape.ai/mcp

Run /mcp in Claude Code to inspect the server and complete OAuth authentication.

Setup with Agent API Key

claude mcp add --transport http datatape https://<org-id>.mcp.datatape.ai/mcp \
  --header "Authorization: Bearer dt_live_your_agent_api_key_here"

Verify Connection

After adding the endpoint, ask Claude to list available tools:

> What tools do you have from Datatape?

Claude will call tools/list on your MCP endpoint and show the available tools.

What Tools Look Like in Claude

When Claude has access to your Datatape tools, it can call them naturally in conversation. For example:

User: "What were our top 5 customers by revenue last quarter?"

Claude: Calls get_customer_revenue with {"start_date": "2025-10-01", "end_date": "2025-12-31", "limit": 5}

Claude sees the tool's description and parameter schemas, so it knows which tool to call and what arguments to pass. The results are returned as structured data that Claude can summarize, analyze, or present as a table.

Troubleshooting