Servidor MCP do In the Story

O que é

O servidor MCP do In the Story liga o seu assistente de IA à sua conta de autor no In the Story. O MCP (Model Context Protocol) é um padrão aberto para conectar assistentes de IA a outros serviços. O servidor é remoto, então não há nada para instalar.

É para autores. Você precisa de uma conta de autor no In the Story e entra com ela para conectar. Leitores não precisam dele.

O seu assistente consegue consultar seus livros, como os leitores avançam por eles, o que os leitores dizem e quanto você ganha. Também pode criar e alterar rascunhos e enviar uma versão para revisão da equipe do In the Story. Você escolhe o que cada conexão pode fazer.

O que você pode pedir

Pergunte do seu jeito. O assistente escolhe as ferramentas de que precisa. Alguns exemplos:

• Como foram meus livros este mês, comparado com o mês passado?
• Em que ponto os leitores param de ler meu livro mais novo, e a quais finais eles chegam?
• Quais escolhas do meu livro quase ninguém faz?
• O que os leitores estão dizendo nas avaliações de uma e duas estrelas?
• Quanto eu ganhei no último trimestre, por livro e por loja?
• Que problemas os leitores relataram no meu livro mais recente?
• Encontre todos os passos do meu rascunho que falam da faroleira e confira se o nome dela está escrito do mesmo jeito em todos.
• Crie um novo rascunho do meu livro mais recente, encontre becos sem saída ou passos que nenhum leitor alcança, e corrija.

Os dois últimos alteram seus rascunhos, então precisam da permissão Editar seus livros.

Como configurar

Você cria um aplicativo no portal dos autores, adiciona o servidor ao seu cliente MCP e aprova a conexão. Leva poucos minutos.

1. Crie um aplicativo no portal dos autores

   • Entre no portal dos autores em authors.inthestory.app.
   • Abra o menu do usuário e escolha Integrações.
   • Escolha Criar aplicativo e dê um nome a ele.
   • Escolha o que ele pode fazer. Análises (somente leitura) cobre leitura e análises. Edição acrescenta a alteração dos seus rascunhos. Para o assistente poder enviar um rascunho para revisão, marque também Enviar para revisão. Cada permissão é explicada mais abaixo.
   • Deixe Cliente confidencial ligado para um cliente hospedado, que guarda o secret no próprio servidor. Desligue para um cliente que roda no seu computador. Esse tipo não recebe secret e usa PKCE no lugar dele.
   • Copie o Client id e, num aplicativo confidencial, o Client secret. O secret aparece uma única vez. Se você perder, crie um novo aplicativo.

2. Adicione o servidor ao seu cliente MCP

   Qualquer cliente MCP

   1. Adicione um servidor MCP remoto com esta URL:

      https://api.inthestory.app/mcp

      Copiar
   2. Informe o client id e, se o aplicativo for confidencial, o client secret. O servidor não tem registro dinâmico de clientes, então o seu cliente precisa ter onde informar esses dados.
   3. Conecte. O navegador abre o In the Story para a etapa 3.

   O seu cliente precisa atender aos detalhes técnicos no fim desta seção. Um cliente que roda no seu computador funciona se usar um redirecionamento de loopback. Entre os clientes hospedados, hoje só o callback do Claude é aceito.

   Exemplo: claude.ai e o app do Claude para computador

   1. Crie o aplicativo com Cliente confidencial ligado.
   2. No Claude, abra Configurações, depois Conectores e Adicionar conector personalizado, e cole a URL do servidor.
   3. Abra as configurações avançadas e cole o client id e o client secret.
   4. Conecte. O navegador abre o In the Story para a etapa 3.

   Exemplo: Claude Code

   1. Crie o aplicativo com Cliente confidencial desligado.
   2. Rode este comando no terminal, trocando YOUR_CLIENT_ID pelo seu client id. Em Integrações, a linha do aplicativo tem um botão que copia o comando já com o seu client id.

      claude mcp add --transport http --client-id YOUR_CLIENT_ID inthestory https://api.inthestory.app/mcp

      Copiar
   3. Depois rode este. O navegador abre o In the Story para a etapa 3.

      claude mcp login inthestory

      Copiar

3. Aprove a conexão

   O In the Story pede que você entre na sua conta. Confira o nome do aplicativo, o client id e o que ele está pedindo, e escolha Aprovar. Só aprove uma conexão que você mesmo acabou de iniciar. Depois você volta ao seu cliente, já conectado.

Para mudar ou remover depois

• Para mudar o que um aplicativo pode fazer, use Editar permissões na linha dele em Integrações. Uma permissão nova passa a valer depois que você reconecta no seu cliente e aprova.
• Para desconectar, use Revogar aplicativo na linha dele.

Detalhes técnicos

URL do servidor

https://api.inthestory.app/mcp

Transporte

Streamable HTTP, só POST. O servidor não guarda estado: não mantém sessões nem abre um stream do servidor, então GET e DELETE respondem 405.

Versões do protocolo

2026-07-28, 2025-11-25, 2025-06-18 e 2025-03-26.

Login

Fluxo de código de autorização do OAuth 2.1 com PKCE (só S256), tokens de renovação e indicadores de recurso (RFC 8707).

Descoberta

https://api.inthestory.app/.well-known/oauth-protected-resource (também em /.well-known/oauth-protected-resource/mcp) e https://api.inthestory.app/.well-known/oauth-authorization-server

Endpoints

/oauth/authorize, /oauth/token e /oauth/revoke em https://api.inthestory.app

Registro de clientes

Sem registro dinâmico de clientes. Crie o cliente em Integrações. Clientes públicos, sem secret, são aceitos.

Autenticação no token

client_secret_basic, client_secret_post ou none

URIs de redirecionamento

Um endereço de loopback HTTP (127.0.0.1, localhost ou [::1]) em qualquer porta, ou o callback hospedado do Claude, https://claude.ai/api/mcp/auth_callback. Nada além disso é aceito.

Origens de navegador

Um pedido com o cabeçalho Origin é recusado, a menos que essa origem esteja na lista de origens permitidas do servidor.

Permissões

Cada aplicativo tem suas próprias permissões, e são cinco. A predefinição Análises (somente leitura) liga as três primeiras, para leitura e análises. Edição liga as quatro primeiras, para o assistente também alterar rascunhos. Enviar para revisão não está em nenhuma das duas. Marque se quiser que o assistente envie rascunhos para revisão.

• Alguns clientes pedem todas as permissões ao conectar. Eles recebem só as que você marcou no aplicativo, e a tela de aprovação mostra exatamente essas.
• Uma permissão é um limite, não um passe livre. Cada chamada ainda é conferida com o seu próprio acesso ao perfil de autor envolvido. Se no portal você só pode ler o perfil de outro autor, o assistente também só pode ler.
• Nenhuma permissão deixa um aplicativo gerenciar colaboradores. Quem pode trabalhar nos seus livros é decidido no portal.

Segurança e seus dados

Esta seção é para quem decide se libera o servidor, inclusive equipes de TI. Os detalhes do protocolo estão no fim da seção de configuração.

Login e tokens

• O login usa OAuth com PKCE. Todo cliente precisa usar o método S256.
• Um client id e um secret sozinhos não dão acesso a nada. O autor entra no In the Story e aprova cada nova conexão.
• Tokens de acesso valem uma hora. Tokens de renovação são trocados a cada uso.
• Os tokens são emitidos só para este servidor. O resto da API do In the Story os recusa.

Como o acesso é cortado

• Revogar o aplicativo em Integrações corta a conexão na chamada seguinte.
• Remover uma permissão do aplicativo vale a partir da chamada seguinte.
• Se o autor perder o acesso de autor, ou se a conta for desativada ou excluída, todas as conexões param na próxima renovação do token.
• O autor precisa aprovar a conexão de novo a cada 90 dias, não importa com que frequência ela é usada.

Por onde passa cada chamada

• O servidor lê e altera dados só pela mesma API pública do In the Story que o portal dos autores usa, com as mesmas verificações de permissão por autor. Ele não tem acesso direto a dados de livros, de leitores ou de vendas.
• Nada fica em cache. Cada resposta é lida na hora.
• Nenhuma permissão dá acesso de administrador, e as rotas de administração recusam o servidor.
• Cada alteração é conferida com uma lista fixa de ações permitidas. O que não está na lista é recusado.

Como as alterações ficam seguras

• O conteúdo dos livros só muda em rascunhos. A API se recusa a editar uma versão publicada ou em revisão. Para revisar um livro publicado, o assistente cria um novo rascunho, e os leitores continuam com o livro publicado até você publicar a nova versão.
• Importar um perfil de personagem que você já tem salva uma nova versão dele na hora. Seus livros continuam na versão com que foram feitos, então os leitores só veem a mudança quando você publica um livro feito com a nova versão. Versões anteriores não podem ser lidas de volta, então guarde uma cópia do arquivo antigo.
• A publicação continua nas suas mãos. Com Enviar para revisão, um aplicativo pode mandar um rascunho para a equipe do In the Story, e nada além disso. Colocar um livro na loja é feito por uma pessoa, no portal.
• As ferramentas que alteram algo vêm marcadas assim, para o seu cliente poder pedir sua confirmação antes de cada alteração.
• Com qualquer permissão, um aplicativo não pode excluir uma história, uma versão ou um perfil de autor, mudar quem trabalha nos seus livros, transferir a propriedade nem alterar a conta em si, o que inclui criar outra conexão.

As séries são a exceção. Uma série não tem rascunho, então, com Editar seus livros, renomear uma série ou adicionar, remover ou reordenar os livros dela aparece para os leitores na hora, mesmo para livros já publicados. No portal funciona do mesmo jeito.

O que o seu assistente vê

• Tudo o que uma ferramenta devolve passa a fazer parte da sua conversa com o seu assistente de IA. A maioria das ferramentas devolve resumos. Exportar uma versão devolve o texto completo do livro.
• As análises nunca identificam um leitor e não podem ser filtradas por leitor. As avaliações trazem o nome de quem avaliou, como aparece na loja.
• Textos escritos por leitores, como avaliações e problemas relatados, vêm marcados como não confiáveis: são dados para relatar, não instruções para seguir.

Ferramentas

O servidor tem 41 ferramentas. O seu cliente só vê as que as permissões do aplicativo liberam.

Relatórios, leitores e ganhos

Precisa de Ler dados de leitores. Os dois relatórios e o tráfego por passo também precisam de Ler seus livros.

its_get_book_report

Tudo sobre um livro numa chamada só: tamanho, dificuldade, leitores, onde as leituras param, finais alcançados, avaliações, vendas, royalties, problemas e saúde do livro.

its_get_author_report

Seu painel numa chamada só: royalties, vendas, livros vendidos, leitores, conclusão, notas e o funil de leitores, cada um comparado com o período anterior.

its_analyze_sessions

Análises de sessões de leitura por autor, história, versão ou tag. Num livro, agrupa por passo final ou por final.

its_analyze_purchases

Análises de compras, com os mesmos filtros e também por loja.

its_analyze_step_traffic

Como os leitores percorreram um livro, passo a passo: quantos chegaram a cada passo, quantos pararam ali e para onde foram.

its_list_reviews

O que os leitores escreveram sobre um livro: a distribuição de estrelas e depois as avaliações, das mais novas para as mais antigas. Dá para filtrar por estrelas.

its_list_issues

Problemas que os leitores relataram numa história.

its_get_statement

Quanto você ganhou: seus saldos e um extrato do período, linha a linha ou somado por livro, loja ou mês.

Seus livros

Precisa de Ler seus livros.

its_get_me

A conta em nome da qual a conexão age e os perfis de autor que ela pode usar.

its_list_authors

Perfis de autor em que você pode trabalhar, com a sua permissão em cada um.

its_get_author

Um perfil de autor: dados, redes sociais e colaboradores.

its_list_stories

As histórias de um autor. Pode incluir leituras, taxa de conclusão, nota e vendas de cada livro lançado.

its_get_story

Uma história, com um resumo de cada versão.

its_list_story_versions

As versões de uma história, com tag, status, idioma, preço e número de passos.

its_get_story_version

Uma versão: dados, tamanho do livro e, se pedido, seus módulos.

its_list_steps

Um índice dos passos de uma versão, sem o texto.

its_get_step

Um passo completo, ou até dez passos pela referência.

its_search_steps

Encontra passos cujo texto, título ou rótulos de escolha contêm as palavras pedidas.

its_get_version_map

A forma do livro: contagens, o caminho principal, passos inalcançáveis, becos sem saída, decisões-chave e finais. Ou um passo com as ligações de entrada e de saída.

its_list_series

As séries de um autor.

its_get_series

Uma série e seus livros na ordem de leitura.

Catálogo público

Precisa de Ler o catálogo público.

its_search_catalog

Busca na loja pública.

its_get_catalog_item

Um livro publicado, do jeito que o leitor vê.

Edição

Precisa de Editar seus livros. Alterações em histórias só valem para rascunhos. Alterações em séries valem na hora.

its_create_story

Começa uma história nova e o primeiro rascunho dela.

its_create_version

Começa um novo rascunho a partir da versão atual.

its_update_version

Altera título, endereço na web, descrição, categorias, passo inicial ou preço de um rascunho.

its_create_step

Adiciona um passo a um rascunho.

its_update_step

Altera o texto ou a configuração de um passo.

its_delete_step

Remove um passo de um rascunho.

its_create_series

Cria uma série.

its_update_series

Renomeia uma série e define o endereço dela na web.

its_add_series_book

Coloca uma história numa série.

its_set_series_book_number

Define a posição de um livro na ordem de leitura.

its_remove_series_book

Tira uma história de uma série.

Envio para revisão

Precisa de Enviar para revisão.

its_submit_version

Envia um rascunho para aprovação da equipe do In the Story.

Exportar e importar

Importar precisa de Editar seus livros. As outras precisam de Ler seus livros.

its_export_version

Exporta uma versão inteira como texto .ist, uma parte por vez.

its_import_version

Substitui um rascunho por um documento .ist completo.

its_get_import_status

Diz se uma importação deu certo e o que falhou.

its_list_character_profiles

Lista os perfis de personagem de um autor.

its_export_character_profile

Exporta um perfil de personagem como texto.

its_import_character_profile

Cria um perfil de personagem a partir de um documento, ou salva uma nova versão de um que você já tem.

Ajuda

Dúvidas, ou algo não funciona? Escreva para autores@inthestory.app.

Veja também: Política de Privacidade · Termos de Uso