Conectar via MCP

A Anthra fala o Model Context Protocol por Streamable HTTP em /api/mcp. Há duas formas de se conectar:

OAuth — para Claude.ai, ChatGPT e outros clientes que adicionam um servidor pela URL. Cole https://anthra.com/api/mcp, entre na Anthra e aprove a solicitação. Nenhuma chave para copiar.
Chave de API — para arquivos de configuração e scripts do Cursor, Claude Code e Claude Desktop. Envie um dos seus tokens de acesso pessoal como cabeçalho Bearer.

Endpoint

URL:    https://anthra.com/api/mcp
Method: POST (JSON-RPC)
Auth:   OAuth 2.1 (discovered automatically), or
        Authorization: Bearer ant_live_…
Protocol revision: 2025-06-18

Conectar com OAuth (Claude.ai, ChatGPT)

No Claude.ai: Settings → Connectors → Add custom connector. No ChatGPT: ative o modo de desenvolvedor e adicione um conector em Settings → Connectors. Use esta URL:

https://anthra.com/api/mcp

O cliente abre uma página da Anthra que mostra o nome do app e lista o que ele está pedindo para fazer. Entre se precisar, confira as permissões e escolha Permitir. Tudo o que o app gerar é cobrado dos seus créditos, exatamente como seria no estúdio.

Se o cliente não pedir nenhuma permissão específica, ele recebe books:read, books:write, generation:run e account:read. Publicação (publish:write) e análises de leitores precisam ser solicitadas pelo cliente. Os tokens de acesso duram uma hora e se renovam automaticamente por até 30 dias de inatividade. Para cortar o acesso de um app, abra Conta → Chaves de API e escolha Desconectar em Apps conectados.

Para quem desenvolve clientes: a descoberta começa pelo cabeçalho WWW-Authenticate em uma resposta 401, que aponta para /.well-known/oauth-protected-resource (também servido em /.well-known/oauth-protected-resource/api/mcp). Os metadados do servidor de autorização ficam em /.well-known/oauth-authorization-server. A Anthra oferece registro dinâmico de clientes, o grant authorization-code com PKCE (apenas S256), refresh tokens rotativos, revogação de tokens e o parâmetro resource, que deve ser https://anthra.com/api/mcp. As URIs de redirecionamento devem ser https, http em localhost / 127.0.0.1 ou o esquema de uso privado de um app nativo (por exemplo, cursor://…, vscode://…), e são comparadas exatamente.

Conectar com uma chave de API

Crie uma chave em Conta → Chaves de API com os escopos que quiser e adicione-a ao seu cliente como mostrado abaixo.

Claude Desktop

Edite ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou o equivalente no seu sistema:

{
  "mcpServers": {
    "anthra": {
      "url": "https://anthra.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ant_live_…"
      }
    }
  }
}

Reinicie o Claude Desktop. Você deve ver anthra aparecer na lista de ferramentas, com entradas como create_book, generate_outline, write_chapter e publish_book.

Claude Code

claude mcp add --transport http anthra \
  https://anthra.com/api/mcp \
  --header "Authorization: Bearer ant_live_…"

Cursor

Nas configurações do Cursor → Tools & Integrations → Add MCP Server:

{
  "mcpServers": {
    "anthra": {
      "url": "https://anthra.com/api/mcp",
      "headers": { "Authorization": "Bearer ant_live_…" }
    }
  }
}

O que o modelo pode fazer

O servidor MCP da Anthra tem paridade total com o agente de escrita do app da Anthra — o mesmo conjunto de ferramentas, exposto via MCP. O modelo pode:

Listar, ler, criar, atualizar e excluir livros, capítulos e colaboradores (books:read, books:write).
Conduzir a superfície de planejamento — declaração de tema, promessa ao leitor, autores de referência, estrutura de cenas, travas de ponto de vista / tempo verbal, personagens com desejo / medo / mentira, conflitos entre personagens, entrevista de premissa, propostas de premissa, avaliador de esboço, variantes de esboço, detecção de gênero, pesquisa de época, referências de clima, snapshots do esboço.
Gerenciar a bíblia do escritor — personagens, esboço da trama, esboço do tema, guia de estilo, construção de mundo, glossário, sinopse, lore, bíblia do cenário, pesquisa de época. Ler, escrever, rascunhar automaticamente e voltar versões pelas revisões.
Gerar esboços, escrever capítulos, reescrever com uma diretriz, rodar verificações de continuidade / clichês / repetição / desvio de estilo / legibilidade em voz alta / sensibilidade e sintetizar narração (generation:run).
Rodar o pacote completo de análise de prosa — palavras de filtro, densidade de advérbios, equilíbrio sensorial, substantivos concretos, deslizes de ponto de vista, consistência do tempo verbal, ritmo das frases, marcadores de diálogo, linguagem corporal, clichês semânticos, antecipação excessiva e repetição — e depois aplicar as correções (variações de cadência, reescritas no estilo mostre-não-conte, verbos mais fortes).
Convocar o painel de especialistas / críticos — chamar um especialista pelo nome, fazer uma mesa-redonda de crítica, verificar uma afirmação com ceticismo, sintetizar como Editor-Chefe, rodar um torneio de rascunhos, o médico de trama de longo prazo, consultas a especialistas de gênero e a leitura do leitor estreante.
Coletar feedback de leitores — um painel de leitores de teste, um mapa do arco emocional e notas de gancho / final que leem o livro como alguém que o vê pela primeira vez.
Manter a construção de mundo e a continuidade — regras do mundo, verificações de linha do tempo / geografia / clima / tempo de viagem, consistência de unidades, termos e calendários inventados, o registro de prenúncios, rastreadores de objetos e locais, verificações de consistência de cenas e diffs de continuidade.
Aprimorar a construção de personagens — o quadro de desejo / medo / mentira e a matriz de conflitos, além de impressões digitais de diálogo, consistência de voz por personagem e acompanhamento do arco de cada personagem.
Fazer edição por persona e estrutural — edições com controle de alterações usando personas de editor embutidas ou salvas, variantes de frases, troca de tempo verbal / ponto de vista, transplante de voz, corte por porcentagem, expansão, esboço reverso, cartões de cena e uma sinopse — cada uma chegando como sugestão revisável que você aceita ou rejeita.
Avaliar com scorecards e exemplos de avaliação e organizar a caixa de ideias (capturar / organizar / status).
Colaborar — gerenciar colaboradores, distribuir capítulos e ler o feed de atividades de um livro com vários autores.
Capa e produção — escolher a cor da capa, gerar imagens de capa / contracapa / lombada / capítulos, compor a capa completa pronta para impressão, renderizar o manuscrito em EPUB / DOCX / PDF, exportar para Markdown, narrar todos os capítulos em lote e traduzir o livro para outro idioma.
Reestruturação de capítulos — listar, editar, dividir, juntar, reordenar capítulos e voltar a qualquer revisão salva.
Listar o catálogo de vozes de narração (list_voices) para escolher uma voz antes de iniciar a narração.
Publicar livros e alternar a visibilidade (publish:write).
Ler o uso da conta, o status das tarefas em segundo plano e as análises de leitores (account:read, analytics:read).

Ferramentas que alteram dados ou consomem tokens ficam atrás do escopo correspondente — uma chave ou app conectado sem generation:run ainda deixa o modelo listar e ler seus livros, mas não permite geração.

Reduza a lista de ferramentas

A superfície completa tem mais de 300 ferramentas, e muitos clientes funcionam melhor com menos. Acrescente ?toolset= à URL do endpoint para listar apenas algumas categorias, por exemplo https://anthra.com/api/mcp?toolset=core,production,webhooks. As categorias são core, extended, production, parity e webhooks. Só core já cobre montar um livro à mão. Categorias desconhecidas são ignoradas.

Escopos recomendados para um cliente só de chat

books:read
books:write
generation:run
publish:write

Adicione account:read e analytics:read se quiser que o modelo considere gastos ou o comportamento dos leitores.

Veja a referência de ferramentas completa com cada operação, seus argumentos e o escopo que ela exige.