DataFast MCP

Comece com o MCP

Conecte seu assistente de IA ao DataFast para perguntar sobre tráfego, receita e metas personalizadas, ou gerenciar operações do site que você autorizar. Você precisa de uma conta DataFast com acesso à API.

Escolha como conectar

Escolha um método. Ambos usam Streamable HTTP para se comunicar com o DataFast.

• Entrar com OAuth — recomendado para clientes que oferecem login via OAuth, incluindo Codex e Claude Code. Selecione sites e permissões no DataFast; o cliente gerencia seu token de conexão automaticamente. Você não cria nem copia uma chave de API.
• Usar um token de API — para clientes que solicitam um token Bearer. Crie um token de conta com escopo no DataFast e adicione-o à configuração do seu cliente.

Ambos os métodos oferecem as mesmas ferramentas do DataFast. As permissões OAuth permitem aprovar análises, administração do site, ações da conta e gerenciamento de credenciais separadamente. Consulte a referência de ferramentas para saber o que cada método suporta.

Conecte com OAuth

1. Adicione o DataFast ao seu cliente

Adicione um servidor MCP remoto com a URL abaixo e escolha OAuth ou Entrar.

https://datafa.st/api/mcp

Para Codex, adicione o servidor e complete o login no navegador:

codex mcp add datafast --url https://datafa.st/api/mcp

Para entrar novamente mais tarde, execute codex mcp login datafast. Tanto os documentos de metadados do cliente quanto o registro dinâmico são suportados, incluindo callbacks de loopback nativos. Se o DataFast já estiver configurado com um token Bearer, remova essa credencial da configuração do DataFast no cliente antes de mudar para OAuth.

Para Claude Code, adicione o servidor e depois abra /mcp dentro do Claude Code e autentique o DataFast:

claude mcp add --transport http datafast https://datafa.st/api/mcp

2. Entre e aprove o acesso

1. Entre em datafa.st com sua conta DataFast existente.
2. Selecione os sites aos quais este cliente pode acessar.
3. Revise as permissões solicitadas. As permissões de leitura são selecionadas por padrão; habilite gravações somente se quiser que o cliente faça essas alterações.
4. Selecione Permitir acesso para voltar ao seu cliente.

O DataFast emite ao cliente um token de acesso para essa conexão. O cliente o armazena e o renova automaticamente enquanto a conexão permanecer válida. Sua senha do DataFast, sessão do painel e chaves de API existentes não são compartilhadas com o cliente.

3. Experimente

Inicie uma conversa com o DataFast habilitado e pergunte:

Liste meus sites disponíveis e mostre visitantes e receita do meu site nos últimos sete dias.

Confirme o site e o intervalo de datas antes de continuar. Seu plano e permissões continuam valendo.

Gerencie ou revogue a conexão em Configurações → API / MCP → Aplicativos conectados. Reconecte quando o DataFast pedir que você aprove o acesso novamente, ou quando quiser compartilhar sites ou permissões diferentes.

Conecte com um token de API

Use este método quando seu cliente solicitar uma chave de API ou token Bearer. Para MCP, comece com um token de acesso de conta, que começa com dft_.

1. Crie um token de conta

1. Abra Configurações da conta → API / MCP.
2. Em Novo token de acesso, escolha Sites específicos para restringir o acesso, ou Todos os sites se for o que seu fluxo de trabalho precisa.
3. Selecione apenas as permissões necessárias. Para uma conexão de análise, comece com Sites → Leitura e Análises → Leitura, com todas as outras permissões desativadas.
4. Dê um nome reconhecível ao token, selecione Criar token e copie o valor dft_. Ele é exibido apenas uma vez.### 2. Adicione o token ao seu cliente

Use https://datafa.st/api/mcp e envie o token como um cabeçalho Authorization: Bearer …. Mantenha-o nas configurações de credenciais do cliente ou em uma variável de ambiente, fora do controle de versão e de mensagens de chat.

Codex: disponibilize seu token como a variável de ambiente DATAFAST_TOKEN e execute:

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

Claude Code: substitua dft_xxx pelo seu token:

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

Cursor: adicione esta entrada ao seu mcp.json. Disponibilize DATAFAST_TOKEN no ambiente do Cursor; o Cursor expande a variável de ambiente ao conectar.

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

Outros clientes: insira a URL do servidor e o token Bearer nas configurações remotas de MCP. Clientes que suportam apenas servidores stdio locais precisam de uma ponte como mcp-remote.

3. Experimente e gerencie o acesso

Peça ao seu cliente para listar seus sites disponíveis e depois solicite visitantes e receita de um site nos últimos sete dias.

Gerencie o token em Seus tokens de acesso em Configurações da conta → API / MCP. Use Editar permissões para alterar o que ele pode fazer, Rotacionar para substituir o segredo, ou Excluir para revogá-lo. Após rotacionar um token, atualize o valor no seu cliente.

Já tem uma chave de API de site df_? O endpoint MCP geral também aceita essas chaves, com acesso vinculado a esse site. Consulte Autenticação da API para as operações suportadas. Você também pode restringir um token de conta a um único site usando Sites específicos acima.

Como o acesso é limitado

Ambos os métodos dão ao cliente uma credencial secreta. O OAuth automatiza a emissão e renovação dessa credencial após seu consentimento; um token de API é uma credencial que você cria e configura por conta própria.

O DataFast verifica a credencial, a ação permitida, o acesso ao site, a associação atual e as restrições aplicáveis de conta ou plano no servidor. Um ID de site em uma solicitação de ferramenta é um alvo a ser verificado, não uma prova de acesso. Por exemplo, uma conexão OAuth aprovada para ler o Site A não pode ler o Site B nem editar o Site A.

Conexões OAuth acessam apenas sites aprovados. Um site criado por meio de uma ferramenta OAuth aprovada é adicionado a essa conexão; sites adicionados em outros lugares não são compartilhados automaticamente. Tokens OAuth expiram após uma hora, são renovados automaticamente por até 30 dias a partir da emissão e exigem novo consentimento após no máximo 90 dias. Tokens de conta criados no painel permanecem válidos até você rotacioná-los ou excluí-los, sujeitos ao seu acesso e permissões de conta. Chaves de API e tokens de conta emitidos via OAuth também dependem da conexão original permanecer válida.

Tokens OAuth funcionam apenas no endpoint MCP para o qual foram emitidos. Eles não podem ser colados na API REST pública nem usados para entrar no painel do DataFast. Tokens de conta também funcionam com os endpoints REST suportados.

Segurança

• Comece com acesso limitado. Dê ao cliente apenas os sites e permissões que ele precisa. Ações de conta, gerenciamento de credenciais e detalhes completos de visitantes exigem permissões OAuth separadas que estão desativadas por padrão.
• Revise alterações. Ferramentas de gravação OAuth exigem confirmação e uma chave de repetição. Ferramentas com token de API exigem confirmação para operações sensíveis, como excluir dados ou emitir credenciais. Essas verificações complementam a interface de confirmação do cliente; elas não substituem a escolha de um cliente confiável.
• Mantenha credenciais privadas. Ambos os métodos usam tokens Bearer: quem obtiver um token válido pode usar o acesso permitido até que ele expire ou seja revogado. Nunca coloque credenciais em URLs, controle de versão ou mensagens de chat.
• Desconecte quando necessário. Revogar uma conexão OAuth bloqueia solicitações e renovações subsequentes. Uma solicitação já em execução pode terminar, e dados já compartilhados com o outro aplicativo não são excluídos pela revogação.
• Operações exclusivas do painel permanecem no painel. O MCP não pode excluir sites nem conectar/desconectar provedores de pagamento.