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.

Ver em datafa.stExperimente este MCPPatrocinado

O que você pode fazer com DataFast MCP?

  • Visão geral de analytics — Solicite métricas do site, como visitantes, pageviews e tendências, via datafast_analytics_overview.
  • Listar sites — Recupere todos os sites que seu token pode acessar com datafast_websites_list para referência rápida.
  • Gerenciar metas e funis — Crie, atualize ou inspecione metas de conversão e funis para acompanhar as jornadas dos usuários.
  • Revisar detalhes do visitante — Obtenha sessões individuais de visitantes e dados de comportamento para análises mais aprofundadas.
  • Verificar status de integração — Confirme se integrações de pagamento ou outras estão conectadas, sem expor credenciais.
  • Pré-visualizar ações sensíveis — Solicite uma prévia (dry-run) de operações irreversíveis, como exclusões ou emissão de chaves, antes de confirmar com confirm: true.

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 Streamable HTTP em https://datafa.st/api/mcp.

Etapa 1 — Criar um token de conta

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

Where to create a DataFast account token

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

Etapa 2 — Conectar seu cliente

Codex

Salve o token copiado em uma variável de ambiente DATAFAST_TOKEN e 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

  • Gate de confirmação: ferramentas irreversíveis ou que emitem credenciais (excluir, rotacionar, gerar chaves/tokens de API) exigem um argumento confirm: true explícito. Chamar sem ele retorna uma prévia do que aconteceria em vez de executar, 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) — igual à API REST.
  • Exclusão de site somente no painel: não existe ferramenta MCP para excluir um site; a exclusão não pode ser automatizada por design.
  • Conexão/desconexão de pagamento somente no painel: o MCP pode informar 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 contra a rota real — o transporte resolve o bearer uma vez por solicitação e reutiliza esse resultado para autenticação em processo (sem privilégio elevado exclusivo do MCP).

Avançado: Limitar o MCP a um único site

Para uma configuração mais restrita, use uma chave de API de site df_ em vez de um token de conta. Ela limita o cliente a um único 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.