---
title: "Claude Code"
slug: "claude-code"
updated: 2026-07-11T18:55:03Z
published: 2026-07-11T18:55:03Z
canonical: "docs.dataddo.com/claude-code"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dataddo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code

> 🚧 **Prototype**
> 
> 
> The Dataddo MCP server is an early prototype. See the [Dataddo MCP Server overview](/docs/dataddo-mcp-server) for its current capabilities and roadmap.

Connect the [Dataddo MCP server](/docs/dataddo-mcp-server) to [Claude Code](https://code.claude.com), Anthropic's agentic coding tool. Claude Code fully supports remote MCP servers with static Bearer tokens.

## Prerequisites

- A Dataddo API access token. See [Headless API Authorization](/headless/docs/dataddo-api-authorization).
- Claude Code installed.

## Setup

Run:

```
claude mcp add --transport http dataddo https://headless.dataddo.com/mcp \
  --header "Authorization: Bearer <YOUR_ACCESS_TOKEN>"
```

By default the server is added for the current project only. Add `--scope user` (before the server name) to make it available in all your projects.

Alternatively, configure it declaratively - for example in a project's `.mcp.json`, reading the token from an environment variable so it is not stored in the file:

```
{
  "mcpServers": {
    "dataddo": {
      "type": "http",
      "url": "https://headless.dataddo.com/mcp",
      "headers": {
        "Authorization": "Bearer ${DATADDO_TOKEN}"
      }
    }
  }
}
```

Note: if `DATADDO_TOKEN` is not set, Claude Code fails to parse the configuration. Never commit a config file containing a raw token to version control.

Verify the connection inside a Claude Code session with the `/mcp` command - the `dataddo` server should be listed as connected.

## Try It Out

Ask Claude Code:

> Using the Dataddo tools, what is the current time in UTC?

## Troubleshooting

- **Connection reported as failed.** If the configured `Authorization` header is rejected by the server, Claude Code reports the connection as failed. Your access token may have expired - generate a fresh one and re-add the server. See [Authorization](/headless/docs/dataddo-api-authorization).
- **Server not listed in `/mcp`.** Check the scope: a server added with the default scope is only visible in the project where you added it.