Pular para o conteúdo
Servidor MCP

O servidor MCP do Basedash dá ao Claude Code, ao Cursor, ao ChatGPT e a qualquer cliente MCP o mesmo analista de IA do app, com seus modelos e permissões. Faça perguntas e crie dashboards sem sair das suas ferramentas.

Teste de 14 dias. Sem cartão de crédito.

Paid conversions by channel

basedash connected

Which signup channels drove paid conversions this quarter? Then put the chart on our Growth dashboard.

question "Paid conversions by signup channel, weekly, this quarter"

returned response_message · 1 chart · paid_conversions.csv

Referral is the fastest riser: weekly paid conversions climbed from 18 to 46 this quarter, while paid search slipped from 31 to 24. Basedash used your paid_conversions model.

Analytics para mais de 5000 times no mundo

Exa logoTiger Data logoPurpose logoGumloop logoComposio logoFullscript logoShiftrx logoDrata logoExa logoTiger Data logoPurpose logoGumloop logoComposio logoFullscript logoShiftrx logoDrata logo

Analytics headless

Seu cliente passa cada pergunta para o mesmo analista de IA do chat do Basedash. Ele lê seus modelos e seu contexto, escreve e executa o SQL e devolve a resposta com gráficos e arquivos CSV, então seu agente recebe um resultado verificado em vez de um palpite sobre o seu schema.

From your MCP client

ask_question

"What was net revenue by region last fiscal quarter?"

Basedash analyst

Answered
  1. Read the net_revenue model · Models

  2. Applied your fiscal calendar · AI context

  3. Ran SQL on Snowflake · 1.4s

  4. Queried only what Finance can see · Access

  • ↳response_message
  • ↳chart · screenshot
  • ↳net_revenue_by_region.csv

Crie no seu cliente

Peça um dashboard ao seu agente e ele cria um no seu workspace a partir de instruções em linguagem natural, ou adiciona um gráfico a um dashboard que você já tem. Todo resultado leva de volta ao Basedash, e seu agente pode buscar e editar o trabalho a que você tem acesso.

basedash

10 tools

Ask

Build

Look up

ask_question

Ask a question in plain English and get the Basedash analyst's answer. Pass a chat_id to keep going in the same chat.

Scope

  • mcp:chat:ask

Inputs

  • question required
  • chat_id optional

Returns

chat_id, the answer, charts with screenshots, CSV files

get_data_sources

List the databases, warehouses, and apps connected to the workspace, so the client knows what it can ask about.

Scope

  • mcp:chat:ask

Returns

Connected data sources

create_dashboard

Build a dashboard in your workspace from plain-language instructions.

Scopes

  • mcp:chat:ask
  • mcp:dashboards:write

Inputs

  • instructions required

Returns

A link to the new dashboard

edit_dashboarddestructive

Change an existing dashboard from plain-language instructions. Clients see it marked destructive.

Scopes

  • mcp:chat:ask
  • mcp:dashboards:write

Inputs

  • dashboard_id required
  • instructions required

Returns

A link to the updated dashboard

create_chart

Build one chart from instructions, on a dashboard you name or in your drafts.

Scopes

  • mcp:chat:ask
  • mcp:dashboards:write

Inputs

  • instructions required
  • dashboard_id optional

Returns

A link to the chart and a screenshot

edit_chart

Change an existing chart from plain-language instructions.

Scopes

  • mcp:chat:ask
  • mcp:dashboards:write

Inputs

  • chart_id required
  • instructions required

Returns

A link to the chart and a screenshot

list_dashboards

List the dashboards the signed-in person can open.

Scope

  • mcp:dashboards:read

Returns

Dashboards you can access

get_dashboard

Read one dashboard the signed-in person can open.

Scope

  • mcp:dashboards:read

Returns

The dashboard and its charts

list_charts

List the charts the signed-in person can open.

Scope

  • mcp:dashboards:read

Returns

Charts you can access

get_chart

Read one chart the signed-in person can open.

Scope

  • mcp:dashboards:read

Returns

The chart

Governado por padrão

A primeira conexão abre um login OAuth no navegador, sem chave de API para colar num arquivo de configuração. Daí em diante, cada chamada roda como você: o mesmo acesso às fontes, a mesma segurança em nível de linha e os mesmos dados ocultos do app, com escopos separados para perguntar, ler e criar.

charts.basedash.com

Claude Code wants to connect to Acme

Signed in as [email protected] · Finance

  • mcp:chat:ask

    Ask questions and list connected data sources

  • mcp:dashboards:read

    Read the dashboards and charts you can open

  • mcp:dashboards:write

    Create and edit dashboards and charts

Every call runs with your access

Data sources
4 of 6, by group
Row-level security
Region = EMEA

Claude Code is connected

You can close this tab. Questions from Claude Code now run as [email protected], with Finance's access.

Connection cancelled

Claude Code can't reach your workspace until you allow it.

API e Slack

Inicie um chat pela API REST e receba a resposta final numa única requisição, ou acompanhe por streaming enquanto ela é escrita. No Slack, mencione @Basedash num canal e a resposta chega na thread com os gráficos, com as permissões de quem perguntou.

REST API · Start a chat

$ curl -X POST \
  ".../chats?wait=120" \
  -H "Authorization: Bearer bd_key_…" \
  -d '{"message": "Active teams by plan?"}'

201 "status": "finished"
#customer-successThread

Dana @Basedash how many teams were active last week, by plan?

Basedash 235 active teams. Scale leads with 82.

Starter38
Growth64
Scale82
Enterprise51

O que está incluído

Uma URL, um login no navegador e os controles que você já configurou no Basedash.

  • Servidor remoto

    HTTP streamable numa única URL, nada para instalar.

  • Login OAuth

    Conecte pelo navegador, sem chave de API para gerenciar.

  • Acesso por escopo

    Escopos separados para perguntar, ler e criar.

  • Suas permissões

    Cada chamada segue os controles de acesso do app.

  • Gráficos e arquivos

    As respostas chegam com imagens e CSVs.

  • Links para o app

    Dashboards e gráficos novos abrem no Basedash.

  • Nada pela metade

    O Basedash remove um dashboard que falhou ao ser criado.

  • Incluído em todo plano

    Startup e Enterprise, cobrado como uso de IA.

Quais clientes se conectam, como funcionam o login e as permissões, e o que seu agente pode fazer depois de conectado.

Quais clientes de IA podem se conectar ao servidor MCP do Basedash?

Qualquer cliente MCP que aceite servidores remotos via HTTP streamable, incluindo Claude Code, Cursor, ChatGPT e Windsurf, além de frameworks de agentes e ferramentas internas que falem MCP. Adicione https://charts.basedash.com/api/public/mcp como servidor remoto. No Claude Code, rode claude mcp add basedash --transport http seguido da URL. No Cursor, adicione um servidor streamable-http em Settings e depois MCP. No ChatGPT, adicione em Settings e depois Connections. Clientes limitados aos transportes stdio ou SSE não vão se conectar.

Preciso de uma chave de API para usar o servidor MCP?

Não. Na primeira vez que seu cliente se conecta, o Basedash abre um login OAuth no navegador e você aprova a conexão com a sua conta normal do Basedash. O cliente guarda o token que recebe, então não há chave para colar num arquivo de configuração nem para trocar manualmente. Se a janela de login não aparecer, confira se os pop-ups não estão bloqueados, remova o servidor do cliente e adicione de novo, porque alguns clientes só abrem a janela na primeira tentativa.

Quais permissões valem para requisições de um cliente MCP?

Cada chamada de ferramenta roda como a pessoa que fez login. O Basedash aplica o mesmo acesso às fontes de dados, a mesma segurança em nível de linha e as mesmas configurações de visibilidade de dados para a IA do app, então um agente só consulta o que essa pessoa pode consultar e só vê os dashboards e gráficos que ela pode abrir. Os escopos OAuth adicionam uma segunda camada: perguntar usa mcp:chat:ask, ler dashboards e gráficos usa mcp:dashboards:read, e criar ou editar exige mcp:dashboards:write além de mcp:chat:ask.

O que meu agente pode fazer pelo servidor MCP?

ask_question envia uma pergunta ao analista de IA do Basedash e devolve a resposta, eventuais gráficos e arquivos CSV, e pode continuar um chat anterior para perguntas de acompanhamento. get_data_sources lista o que está conectado. create_dashboard, edit_dashboard, create_chart e edit_chart criam a partir de instruções em linguagem natural e devolvem links para o Basedash. list_dashboards, get_dashboard, list_charts e get_chart encontram o trabalho existente a que a pessoa conectada tem acesso.

Devo usar o servidor MCP ou a API REST?

Use o servidor MCP quando alguém trabalha num cliente de IA e quer o Basedash como uma das ferramentas dele: o login é OAuth e o cliente decide quando chamá-lo. Use a API REST quando o seu próprio código precisa de respostas, como um job de backend, um app interno ou um script agendado. Ela autentica com uma chave de API criada nas configurações, pode esperar a resposta final ou transmiti-la por server-sent events, e também cobre gráficos, dashboards, modelos, automações e a administração do workspace.

O servidor MCP está incluído no meu plano?

Sim. O servidor MCP está incluído nos planos Startup e Enterprise, sem nada extra para ativar. As perguntas feitas por ele passam pelo mesmo analista de IA do app, então contam para o uso de IA do workspace como qualquer outro chat. Se o workspace esgotar o uso de IA, as perguntas de clientes MCP deixam de ser respondidas até que haja uso disponível de novo, enquanto a consulta a dashboards e gráficos existentes continua funcionando.

Para onde vão os dashboards e chats criados via MCP?

Os dashboards e gráficos que seu agente cria ficam salvos no seu workspace do Basedash como qualquer outro. Um dashboard novo aparece junto com os demais, e um gráfico criado sem dashboard vai para os seus rascunhos, com um link no resultado da ferramenta nos dois casos. A conversa em si fica no seu cliente: chats iniciados via MCP ficam fora da lista de chats do Basedash, para que o tráfego dos agentes não lote o histórico do app.

O agente do Basedash também pode chamar outros servidores MCP?

Sim, na direção oposta. O servidor MCP permite que agentes externos usem o Basedash, e os conectores MCP permitem que o agente do Basedash use ferramentas externas. Adicione um servidor MCP remoto, como Linear, HubSpot ou um criado pelo seu time, e o agente pode buscar contexto nele e agir por lá enquanto analisa seus dados. Para cada ferramenta, você decide se ela roda sozinha, espera aprovação ou fica bloqueada.

Adicione uma URL ao seu cliente MCP, faça login e seus dados vão junto.