DataFast MCP

oficial

O servidor DataFast MCP permite que clientes compatíveis com MCP, como Codex, Claude Code e Cursor, consultem suas análises e gerenciem sua conta por meio de linguagem natural.

O que você pode fazer com Data Fast MCP?

  • Visão geral de análise de consultas — Solicite métricas de todo o site, como visualizações de página, visitantes e taxa de rejeição usando datafast_analytics_overview.
  • Listar e gerenciar sites — Recupere todos os sites da sua conta com datafast_websites_list e inspecione a configuração deles.
  • Gerenciar membros da equipe — Convide, liste, atualize funções ou remova membros da equipe por meio das ferramentas datafast_team_*.
  • Criar e visualizar metas — Configure metas de conversão e verifique o status atual delas com as ferramentas datafast_goals_*.
  • Inspecionar desempenho do funil — Obtenha dados das etapas do funil para ver onde os visitantes desistem usando as ferramentas datafast_funnels_*.
  • Monitorar alertas — Liste e configure regras de alerta por meio de datafast_alerts_* para ficar por dentro das mudanças no tráfego.

Documentação

Servidor MCP DataFast

O servidor MCP DataFast permite que clientes compatíveis com MCP, como Codex, Claude Code e Cursor, consultem suas análises e gerenciem sua conta por meio de linguagem natural. Ele oferece a mesma funcionalidade, permissões e verificações de segurança que a API REST e a CLI.

Ele usa HTTP Transmissível em https://datafa.st/api/mcp.

Passo 1 — Criar um token de conta

Abra Configurações da Conta → API / MCP, escolha quais sites e permissões o cliente pode acessar e, em seguida, crie um token. Copie o token dft_ quando ele aparecer — você o usará na próxima etapa, e ele é exibido apenas uma vez.

Cada solicitação MCP usa as permissões e o acesso ao site que você selecionou para o token.

Passo 2 — Conectar seu cliente

Codex

Salve o token copiado em uma variável de ambiente DATAFAST_TOKEN e, em seguida, adicione o DataFast:

codex mcp add datafast
--url https://datafa.st/api/mcp
--bearer-token-env-var DATAFAST_TOKEN

Claude Code

claude mcp add --transport http datafast https://datafa.st/api/mcp
--header "Authorization: Bearer dft_xxx"

Cursor, Claude Desktop e outros clientes baseados em configuração

{ "mcpServers": { "datafast": { "url": "https://datafa.st/api/mcp", "headers": { "Authorization": "Bearer dft_xxx" } } } }

Clientes que suportam apenas stdio

Faça a ponte com mcp-remote:

{ "mcpServers": { "datafast": { "command": "npx", "args": [ "-y", "mcp-remote", "https://datafa.st/api/mcp", "--header", "Authorization: Bearer dft_xxx" ] } } }

Ferramentas

Consulte a referência completa de ferramentas — análises, sites, chaves de API, equipe, metas, funis, visitantes, alertas, conta, tokens de acesso e status de integração. Os nomes das ferramentas seguem datafast_<resource>_<action>, por exemplo, datafast_analytics_overview, datafast_websites_list.

Segurança

  • Barreira de confirmação: ferramentas irreversíveis ou que emitem credenciais (excluir, reverter, gerar chaves de API/tokens) exigem um argumento confirm: true explícito. Chamá-las sem ele retorna uma prévia do que aconteceria em vez de executar a ação, para que um agente não possa disparar uma ação sensível na primeira tentativa.
  • Sem exfiltração de segredos: os endpoints de listagem de chaves de API e tokens de acesso nunca retornam valores secretos, apenas metadados (id, nome, prefixo, datas) — o mesmo que a API REST.
  • Exclusão de site é apenas pelo painel: não há ferramenta MCP para excluir um site; a exclusão não pode ser automatizada por design.
  • Conexão/desconexão de pagamento é apenas pelo painel: o MCP pode relatar o status da integração, mas conectar ou desconectar provedores de pagamento (e lidar com suas credenciais) permanece no painel.
  • Escopo por token, não por ferramenta: cada chamada de ferramenta revalida as permissões em relação à rota real — o transporte resolve o portador uma vez por solicitação e, em seguida, reutiliza esse resultado para autenticação em processo (sem privilégio elevado exclusivo do MCP).

Avançado: Limitar o MCP a um site

Para uma configuração mais restrita, use uma chave de API de site df_ em vez de um token de conta. Isso limita o cliente a um site e a análises majoritariamente somente leitura. Crie uma na página Configurações → API / MCP desse site e consulte autenticação e escopos para obter detalhes.

Relacionados

  • Referência de ferramentas
  • Autenticação e escopos
  • CLI do DataFast
  • API da Conta