Press CTRL+K to open search

Claude

  • 6 minute(s) read
Prev Next

Claude is Anthropic's AI assistant. This destination lets Claude read data from any source you connect in Dataddo, so you can ask questions about your data in plain language. Dataddo delivers the data directly to the model and takes care of the rest.

Dataddo handles the whole pipeline for you. It keeps the data fresh, stores it in SmartCache, and serves it through a built-in querying layer. Every answer comes with metadata: technical metadata such as data freshness, and business metadata such as what each table and column means. You do not write any code.

How It Works

On the Data Anywhere and Enterprise plans, Claude is a destination, and the data comes from the flows you attach to it. On the Data to AI plan, Claude is an AI Model, and the data comes from the Contexts you attach to it. A Context is data that Dataddo keeps ready to query. When Claude needs data, Dataddo serves it from SmartCache and returns the rows together with their freshness and business metadata.

Access is authorized with OAuth. You sign in to Dataddo from Claude once, with your Dataddo email and password. Claude then keeps the connection active and renews it in the background, so you do not handle any tokens.

What Claude Can Do with Your Data

Dataddo exposes your data through its data MCP server at https://headless.dataddo.com/mcp-data. The server is a semantic layer: Claude asks in business terms (customers, invoices, deals), and Dataddo never accepts SQL from the model. The tools fall into these groups:

Tools Purpose
list_flows, describe_flow See which flows are available to your account and what each one holds.
list_models, list_entities, describe_entity, search, sample_values Find the business entities, fields, relationships and metrics that can be queried.
query Query an entity by field names, with filters, grouping, date grains and predefined metrics.
data_status, known_gaps Check how fresh the data is and which questions the data cannot answer.
refresh, report_problem Request fresh data for an entity, or report an answer that looks wrong.

A flow or Context can be available but not yet queryable. The model can see it as soon as it is attached, but it can query it only after a semantic model covers it. list_flows reports this for each one.

Setup Overview

The steps depend on your Dataddo plan:

  • On the Data Anywhere and Enterprise plans, you work with sources, flows and destinations.
  • On the Data to AI plan, you work with Contexts and AI Models instead.
  1. Create a Claude authorizer.
  2. Make your data available:
    • Data Anywhere and Enterprise: create a Claude destination that uses the authorizer, then attach one or more flows to it.
    • Data to AI: create a Claude AI Model that uses the authorizer, then attach one or more Contexts to it.
  3. Add the Dataddo connector in Claude and sign in with your Dataddo account.

After you sign in, Claude can access every flow or Context attached to an AI destination or AI Model in your Dataddo account, not only the ones attached to Claude. Their data appears after they run for the first time.

Authorize Connection to Claude

Authorize the connection so Dataddo can serve your data to Claude:

  1. Go to Authorizers and click Authorize New Service.
  2. Select Claude.
  3. Fill in the field below and click Save. Dataddo validates the connection when you save it.
Field Description
Label A name for this authorizer in Dataddo.

Make Your Data Available to Claude

Follow the steps for your plan.

Data Anywhere and Enterprise Plans

  1. Go to Destinations, click Create Destination, and select Claude.
  2. Enter a name, choose the authorizer you created, and click Save.
  3. Go to Flows and click Create Flow.
  4. Add one or more sources.
  5. Add the Claude destination.
  6. Set the schedule that keeps the data fresh and click Save.

Data to AI Plan

  1. Go to AI Models and add a new one.
  2. Select Claude.
  3. Enter a name and choose the authorizer you created.
  4. Attach one or more Contexts to the AI Model.
  5. Click Save.

Set Up the Connection in Claude

You can connect from Claude (the web app, Claude Desktop and the mobile apps share the same connectors) or from Claude Code.

Claude

Custom connectors are available on all Claude plans. On the Free plan, you can add one custom connector.

Add the Connector

On the Pro and Max plans, you add the connector yourself. On the Team and Enterprise plans, an Owner adds it once for the organization, and each member then connects with their own Dataddo account.

  1. Open the connector settings:

    • Pro and Max: go to Customize > Connectors, click + Add, and select Add custom connector.
    • Team and Enterprise (Owners only): go to Organization settings > Connectors and click Add > Custom > Web.

  2. Fill in the two fields and click Continue:

    Field Value
    Name Dataddo Data Access
    URL https://headless.dataddo.com/mcp-data

  3. Under Authentication, select Sign in now. Claude detects that the server uses OAuth.

  4. For the OAuth client, keep Use Claude's published identity (Recommended).

  5. Do not add any request headers.

  6. Click Add.

Sign In to Dataddo

  1. Claude opens the Dataddo sign-in page. On the Team and Enterprise plans, each member starts it by going to Customize > Connectors and connecting Dataddo Data Access.
  2. Enter your Dataddo email and password, and complete multi-factor authentication if you are asked to.
  3. After you sign in, you return to Claude, and the connector shows as connected.

Claude shows the connector's tool permissions. For each tool, you can choose whether Claude may use it freely or must ask you first.

Use It in a Chat

In a chat, open the + menu, go to Connectors, and enable Dataddo Data Access. Then ask a question about your data, for example "Which flows do I have in Dataddo?".

Claude Code

  1. Add the server from your terminal:

    claude mcp add --transport http dataddo https://headless.dataddo.com/mcp-data

  2. Sign in. Run claude mcp login dataddo, or run /mcp inside Claude Code, select the dataddo server and authenticate. A browser window opens with the Dataddo sign-in page.

  3. Enter your Dataddo email and password, and complete multi-factor authentication if you are asked to.

  4. Run /mcp and check that the dataddo server shows Connected.

Claude Code stores the credentials in your system keychain and renews them automatically. To sign out, run claude mcp logout dataddo.

Troubleshooting

  • A flow or Context is missing: attach it to an AI destination or AI Model in the Dataddo account you signed in with, then let it run.
  • The connector shows a Connect button, or Claude Code shows Needs authentication: the sign-in expired or was revoked. Connect again, or select Re-authenticate in /mcp, and sign in to Dataddo.
  • Claude does not open the Dataddo sign-in page: check that the URL is exactly https://headless.dataddo.com/mcp-data, that Sign in now is selected, and that you did not add an authorization request header. If the connector was added differently, remove it and add it again.
  • You see data from the wrong Dataddo account: you signed in with a different account. Disconnect the connector, then connect it again and sign in with the right account.
  • A flow or Context is listed but Claude cannot query it: it is available but no semantic model covers it yet.
  • Claude cannot fetch data: check that the flow has run at least once, so the Context holds data.
  • Stale data: review the flow schedule. Dataddo serves the most recent data it has stored for the Context.

Related Articles