Agent Planners

TL;DR

O Agent Planners agora tem uma superfície de integração de saída: uma API REST pública e um servidor MCP, ambos autenticados com chaves de API por organização. Aponte o Claude Desktop ou o Claude Code para o servidor MCP, ou chame a API REST a partir do Codex, de um cron job ou do seu próprio script, e ele poderá criar uma tarefa, consultar o status e listar suas contas conectadas — rodando no mesmo orquestrador, com os mesmos créditos e as mesmas gravações sujeitas a aprovação que uma tarefa iniciada manualmente no Workspace.

O que foi lançado

Duas formas de entrada, um mesmo mecanismo subjacente: uma API REST em /api/v1\ (criar uma tarefa, verificar status e relatório, listar contas conectadas) e um servidor MCP em /api/mcp\ expondo as mesmas três ações como ferramentas — create\_task\, get\_task\, list\_accounts\. Ambos são autenticados da mesma forma: uma chave de API por organização que você gera no painel, enviada como token Bearer.

Funciona com Claude, Codex ou qualquer coisa que fale HTTP

Clientes MCP conectam-se diretamente — adicione a URL do servidor e sua chave como cabeçalho Bearer na configuração MCP do Claude Desktop ou do Claude Code, e as três ferramentas aparecem ao lado dos seus outros servidores MCP.

Todo o resto — Codex, um job de CI, um script cron, a camada de ferramentas de outro framework de agentes — pode acionar exatamente a mesma funcionalidade pela API REST simples. É apenas um endpoint HTTP com token Bearer; não há requisito específico de MCP para usá-lo.

REST vs MCP — mesmas ações, dois formatos

	API REST (/api/v1)	Servidor MCP (/api/mcp)
Melhor para	Codex, scripts, CI, qualquer coisa com capacidade HTTP	Claude Desktop, Claude Code, outros clientes MCP
Criar uma tarefa	POST /tasks	ferramenta create_task
Verificar status / relatório	GET /tasks/:id	ferramenta get_task
Listar contas conectadas	GET /accounts	ferramenta list_accounts
Autenticação	Authorization: Bearer <key>	Cabeçalho Authorization na configuração do cliente MCP

Mesmas proteções, agora acionáveis de fora do aplicativo

Esta é uma porta de saída para o mesmo mecanismo que o Workspace usa — não um atalho para contorná-lo. Uma tarefa criada pela API ou MCP executa o pipeline normal de orquestrador → especialistas → portão de aprovação, então nada muda em relação ao cuidado com que ela se comporta só porque veio do Codex em vez de uma aba do navegador.

• As chaves são limitadas à organização e armazenadas como hash — uma chave só pode agir como sua própria organização, e um vazamento de banco de dados não pode ser reproduzido contra a API.
• Tarefas externas consomem os créditos da sua organização exatamente como uma tarefa iniciada no Workspace.
• Gravações ainda passam pela pilha de aprovação e proteções da organização, a menos que a tarefa defina explicitamente autoApprove\ — e mesmo assim, os limites de proteção continuam valendo.
• As chaves são limitadas (tasks:write\, tasks:read\, accounts:read\), com limite de taxa por chave e revogáveis instantaneamente pelo painel.

Configuração

1. 1Abra API & MCP no seu painel e clique em "Nova chave".
2. 2Dê um rótulo (ex.: "Claude Desktop — meu notebook" ou "Job de CI do Codex") e escolha os escopos — comece com os três, a menos que saiba que quer menos.
3. 3Copie a chave bruta imediatamente — ela é exibida apenas uma vez e armazenada somente como hash depois disso.
4. 4Para um cliente MCP: adicione a URL do servidor com a chave como cabeçalho Bearer na configuração MCP. Para qualquer outra coisa: chame a base REST com Authorization: Bearer <key\>\.
5. 5Revogue a chave na mesma página a qualquer momento para cortar o acesso imediatamente.

Perguntas frequentes

Isso contorna o portão de aprovação?

Não. Tarefas criadas pela API ou servidor MCP executam o mesmo pipeline de orquestrador e portão de aprovação que uma tarefa iniciada no Workspace — gravações ainda pausam para aprovação, a menos que a tarefa defina autoApprove, e os limites de proteção continuam valendo de qualquer forma.

O Codex pode usar isso, ou apenas o Claude?

Ambos. O Claude Desktop e o Claude Code (e outros clientes MCP) conectam-se diretamente ao servidor MCP. O Codex, um script, um job de CI ou qualquer outro agente que possa enviar uma requisição HTTP pode acionar a funcionalidade idêntica pela API REST simples com a mesma chave Bearer.

Isso custa extra?

Não há preço separado — tarefas criadas externamente consomem os créditos normais da sua organização, da mesma forma que uma tarefa executada no Workspace.

Como isso difere da documentação MCP existente?

Na direção oposta. Adicionar seu próprio servidor MCP permite que o agente chame suas ferramentas. Este recurso permite que um agente externo — Claude, Codex, um script — chame o Agent Planners e execute tarefas nas suas contas.

Posso limitar o que uma chave pode fazer?

Sim — cada chave é limitada a tasks:write, tasks:read e/ou accounts:read na criação, e pode ser revogada instantaneamente, independentemente das suas outras chaves.