API e MCP — Estoile para desenvolvedores

Privacidade: a transcrição completa nunca fica nos servidores do Estoile; ela está só no aparelho de quem gravou. A API e o MCP leem a ata: resumo, pontos discutidos, decisões, tarefas, pendências e riscos.

1. Crie uma chave

Em Configurações › Plano e uso, na seção API e MCP, dê um nome à chave e clique em Criar chave. Ela começa com est_live_ e aparece uma vez só: guarde num lugar seguro. Dá para revogar a qualquer momento na mesma tela.

A API e o MCP fazem parte do plano Max (e do plano Empresa). Cada chave aceita até 60 pedidos por minuto.

2. Conecte sua IA (MCP)

O endereço do servidor MCP é https://escriba-site-zeta.vercel.app/mcp (Streamable HTTP). A chave vai no cabeçalho Authorization: Bearer est_live_....

Claude Code

claude mcp add --transport http estoile https://escriba-site-zeta.vercel.app/mcp \
  --header "Authorization: Bearer est_live_SUA_CHAVE"

Claude Desktop

Em Configurações › Desenvolvedor › Editar configuração (claude_desktop_config.json). Precisa do Node.js instalado:

{
  "mcpServers": {
    "estoile": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://escriba-site-zeta.vercel.app/mcp",
               "--header", "Authorization:${ESTOILE_AUTH}"],
      "env": { "ESTOILE_AUTH": "Bearer est_live_SUA_CHAVE" }
    }
  }
}

Cursor

Em ~/.cursor/mcp.json (ou .cursor/mcp.json no projeto):

{
  "mcpServers": {
    "estoile": {
      "url": "https://escriba-site-zeta.vercel.app/mcp",
      "headers": { "Authorization": "Bearer est_live_SUA_CHAVE" }
    }
  }
}

Codex

Em ~/.codex/config.toml, com a chave numa variável de ambiente (export ESTOILE_API_KEY=est_live_SUA_CHAVE):

[mcp_servers.estoile]
url = "https://escriba-site-zeta.vercel.app/mcp"
bearer_token_env_var = "ESTOILE_API_KEY"

Outras IAs

Qualquer cliente MCP que aceite servidor remoto por HTTP com cabeçalho personalizado funciona: use o endereço acima e o cabeçalho Authorization.

Ferramentas do MCP

Ferramenta	O que faz
`listar_reunioes`	Lista as reuniões, com filtros por data, pasta e série, paginada.
`buscar_reunioes`	Busca no título, resumo, decisões, tarefas, pendências, riscos e tags.
`ver_ata`	Traz a ata completa de uma reunião.
`listar_tarefas`	Tarefas abertas, feitas ou todas, com a reunião de origem.
`marcar_tarefa_feita`	Marca uma tarefa como feita (ou reabre).

Experimente perguntar: "O que ficou decidido nas reuniões com a Acme este mês?" ou "Quais tarefas minhas estão abertas?"

3. API REST

Base: https://escriba-site-zeta.vercel.app/api/v1. Respostas em JSON; sempre com Authorization: Bearer est_live_....

curl https://escriba-site-zeta.vercel.app/api/v1/reunioes?desde=2026-11-01 \
  -H "Authorization: Bearer est_live_SUA_CHAVE"

Rota	O que devolve
`GET /reunioes`	Reuniões, da mais recente. Filtros: `desde`, `ate` (AAAA-MM-DD), `pasta`, `serie`, `arquivadas=1`. Paginação: `pagina`, `por_pagina` (até 100); a resposta traz `proxima_pagina`.
`GET /reunioes/:id`	A reunião com a ata: `resumo`, `pontos`, `decisoes`, `tarefas`, `pendencias`, `riscos`, `pauta`. O campo `transcricao` é sempre `null`.
`GET /tarefas`	Tarefas de todas as atas. `situacao=abertas\|feitas\|todas` (padrão: abertas), `responsavel`.
`GET /busca?q=`	Reuniões que contêm os termos, com `encontrado_em`.
`PATCH /reunioes/:id/tarefas/:indice`	Corpo `{"feita": true}` marca a tarefa como feita (`false` reabre).
`GET /eu`	Plano e limite por minuto da chave.

Erros e limites

Os erros vêm como {"error": "...", "code": "..."}: 401 chave ausente, inválida ou revogada; 403 plano sem API ou conta suspensa; 404 reunião não encontrada; 429 mais de 60 pedidos por minuto (veja o cabeçalho Retry-After). Cada resposta traz X-RateLimit-Remaining.

A API e o MCP só enxergam as reuniões da própria conta. Reuniões que colegas compartilham numa área da empresa não aparecem por aqui.

Dúvidas? Escreva para o suporte.

Suas reuniões dentrodo Claude e do Cursor