Connect AI

Use your Orcabase data from Claude and ChatGPT over MCP: what your assistant can do, what it can’t, and how it compares with the Data Agent.

Already work in Claude or ChatGPT? Connect Orcabase, and your assistant can look up your data, run queries, use your certified metrics and build charts and dashboards in Orcabase, right from the conversation you’re already in.

How it works

AI assistants reach other apps through MCP (Model Context Protocol), an open standard for giving an assistant tools. Orcabase runs an MCP server at:

https://api.tini.so/api/mcp

Your assistant connects with an API token that belongs to one organization. The token decides whose data the assistant can see, so it can only ever reach that one organization, whatever it asks for.

What your assistant can do

  • Find its way around: list your data sources, schemas and tables, read a table’s columns, and preview sample rows.
  • Answer questions: run SQL, re-run saved queries, and compute certified metrics by name, getting back the SQL that ran so answers can be checked.
  • Build things: save queries with charts, create dashboards and pin charts to them, create notebooks, and draft data models and metrics.

The full list is in the tools reference. Things it saves show up in Orcabase like anything else, with the token’s name as their creator.

What it can’t do

  • Edit or delete anything that already exists: queries, dashboards, models or metrics.
  • Certify metrics. The metrics it creates are drafts, until a person certifies them in Orcabase.
  • Add or change data sources, or upload data. Connections are set up by people, in Orcabase, because they involve passwords.
  • Reach another organization, or anything in Orcabase’s settings.

Note

The SQL your assistant runs uses each data source’s own login, the same as SQL you run in Orcabase. Connect your databases with read-only users and nothing it runs can change your data. See Security.

The built-in agent or your assistant?

Data Agent in OrcabaseClaude or ChatGPT
Where you askInside Orcabase, next to your dashboardsIn the assistant you already use
AnswersInsight, a chart you can change, and the stepsIn the assistant’s own style
AI costsOrcabase AI credit, or your own gateway keyYour Claude or ChatGPT plan
ConversationsSaved in OrcabaseSaved in the assistant
Tools and guardrailsThe same toolsThe same tools, plus notebooks

Many teams use both: the agent for everyone in Orcabase, and Claude for whoever lives in it.

Set it up

Something unclear or missing? Troubleshooting covers the common errors, or message us.

↑↓ to move↵ to openesc to close