Atako MCP

Atako MCP

Conecte o Claude Code, Claude Desktop, Cursor ou ChatGPT à sua conta Atako por meio do Model Context Protocol.

A Atako executa um servidor Model Context Protocol (MCP) em https://api.atako.ai/mcp, para que um cliente de IA que você já usa — Claude Code, Claude Desktop, Cursor, modo desenvolvedor do ChatGPT ou qualquer outro cliente MCP — possa ler e agir sobre sua conta Atako diretamente: seus agentes, seu histórico de conversas e arquivos, conexões de integração, atividade, créditos e assinatura.

Observação

A maioria das ferramentas lê o estado existente. Algumas agora também escrevem: criar, renomear, encerrar e retomar agentes; enviar uma mensagem e aguardar a resposta; enviar um arquivo para um agente; conectar uma integração e concedê-la a um agente. Duas coisas ainda precisam de você em um navegador — uma conexão de integração OAuth precisa do seu consentimento na própria página do provedor, e qualquer alteração de cobrança/assinatura acontece em app.atako.ai — nenhuma ferramenta pode fazer isso por você.

Vá para o início rápido para configurações de cliente copiáveis.

Conectando

Você precisa de uma chave de API programática (aik_…) em Configurações → Chaves de API. Aponte seu cliente MCP para a URL abaixo com essa chave como um token Bearer:

URL:     https://api.atako.ai/mcp
Header:  Authorization: Bearer aik_...

O transporte é HTTP Streamable (o transporte recomendado pela especificação MCP atual) — sem instalação separada para a maioria dos clientes, pois eles o suportam nativamente.

Uma chave age como seu usuário proprietário: um cliente MCP conectado com sua chave pode fazer exatamente o que você faria logado no aplicativo — ler e gerenciar seus próprios agentes, além de qualquer agente criado por seus colegas de equipe ao qual você tenha acesso por meio de uma equipe compartilhada ou visibilidade em toda a empresa.

Experimente

Algumas coisas que você pode pedir, uma vez conectado:

• "Liste meus agentes Atako e me diga quais estão ociosos."
• "Crie um agente que tria meus tickets do Zendesk e redige respostas."
• "Envie uma mensagem ao meu agente de suporte pedindo a contagem de tickets de hoje e aguarde a resposta."
• "Conecte meu token do GitHub e conceda-o ao meu agente de engenharia, somente leitura."
• "Qual é meu saldo de créditos e quantos assentos de agente ainda tenho?"

Ferramentas

Leitura

Ferramenta	O que retorna
list_agents	Todos os agentes que você pode ver, com status e uma prévia da última mensagem
get_agent	Detalhes completos de um agente
whoami	Sua identidade, empresa e plano de assinatura
list_messages	Seu histórico de conversas com um agente
wait_for_reply	Bloqueia (até 25s) pela próxima resposta de um agente — chame logo após send_message
list_cron_jobs	Tarefas agendadas recorrentes de um agente e seu histórico de execução
list_sub_agents	Subagentes que um agente criou para delegar trabalho
list_interagent_messages	Mensagens que um agente trocou com colegas da empresa
list_activity	Linha do tempo de atividade ao vivo de um agente (turnos, chamadas de ferramenta, subagentes)
get_activity_state	Se um agente está trabalhando no momento
list_agent_files	Arquivos que um agente pode acessar atualmente
list_integration_catalog	Todas as integrações de terceiros que a Atako suporta
list_integration_connections	Suas próprias integrações conectadas
list_agent_integration_grants	Quais conexões um agente pode usar e como
get_connect_url	Inicia uma conexão OAuth e retorna a URL para abrir em um navegador
get_credits	Saldo de créditos da sua empresa e consumo neste período
get_subscription	Plano, status e uso de assentos de agente da sua empresa
list_models	Modelos de IA disponíveis ao criar/configurar um agente
list_harnesses	Ambientes de execução disponíveis ao criar um agente

Escrita

Ferramenta	O que faz
create_agent	Cria um novo agente — apenas name é obrigatório
update_agent_name	Renomeia um agente
end_agent	Encerra um agente ativo, liberando seu assento
resume_agent	Retoma um agente pausado
cancel_agent_provisioning	Cancela um agente ainda em provisionamento
retry_agent_provisioning	Tenta novamente um provisionamento com falha
send_message	Envia uma mensagem de chat para um agente (dispare e esqueça — combine com wait_for_reply)
upload_file_to_agent	Envia um arquivo (≤10 MiB, base64) e o concede a um agente, em uma única chamada
create_integration_connection	Conecta uma integração colando uma chave/token de API
grant_integration_to_agent	Concede a um agente acesso a uma conexão e quais ações
revoke_integration_grant	Revoga o acesso de um agente a uma integração

Um endpoint público, sem autenticação, em https://api.atako.ai/mcp/public também expõe 3 ferramentas de marketing sem exigir chave de API — get_pricing, list_use_cases e list_integration_pages — úteis para um assistente que pesquisa a própria Atako em vez de agir sobre sua conta.

Agendamento e delegação são criados pelo agente

Não há ferramenta create_cron_job ou create_sub_agent, de propósito: um agente agenda suas próprias tarefas recorrentes e cria seus próprios subagentes enquanto trabalha, em resposta a ser solicitado em uma conversa normal — não por meio de uma API de criação separada. Diga ao agente o que você quer ("toda segunda-feira às 9h, verifique X e me envie um resumo") e depois use list_cron_jobs para confirmar o que ele configurou e inspecionar seu histórico de execução.

Duas coisas ainda precisam de um navegador

• Integrações OAuth — get_connect_url fornece a URL de autorização, mas concluir uma tela de consentimento OAuth exige que você esteja em um navegador real. Para um provedor que só precisa de uma chave/token de API colado, create_integration_connection funciona sem nenhuma etapa de navegador.
• Alterações de cobrança e assinatura — não há ferramenta MCP para isso. Vá para app.atako.ai → Configurações → Cobrança.

Recursos e prompts

• Recursos: atako://agents/{id} (mesma forma que get_agent), atako://agents/{id}/files (mesma forma que list_agent_files) e atako://docs/quickstart (o guia de início rápido deste produto, para um cliente que queira se basear no que é a Atako antes de chamar qualquer ferramenta).
• Prompts: diagnose_agent_issue (reúne o estado, a atividade e as mensagens recentes de um agente para ajudar a descobrir por que ele parece travado), weekly_credits_report (um resumo rápido de créditos/assinatura/lista de agentes), create_support_agent_from_brief (transforma uma descrição livre em uma chamada estruturada create_agent) e connect_integration_wizard (orienta a conexão de um provedor de ponta a ponta, escolhendo a ferramenta certa para como ele autentica).

O que vem a seguir

OAuth 2.1 com Registro Dinâmico de Cliente — uma experiência de "conectar" com um clique a partir de conectores claude.ai/ChatGPT em vez de colar uma chave de API — está planejado para uma versão futura, junto com um modelo de escopo granular mais restrito do que "esta chave pode fazer tudo que seu proprietário pode".