Quilvo

O que o servidor faz

O Quilvo expõe um servidor MCP focado para assistentes pessoais de IA e automação local. Ele é intencionalmente menor que a API JSON: assistentes podem descobrir o contexto do projeto, inspecionar o histórico de sessões e registrar uma sessão de escrita quando o usuário solicitar.

Endpoint https://quilvo.app/mcp/quilvo

Transporte HTTP MCP

Autenticação OAuth

Concessão mcp:use

Autenticação

Conecte-se com OAuth

Clientes MCP hospedados conectam-se ao Quilvo através do fluxo OAuth padrão. Adicione o endpoint, faça login no Quilvo e aprove a conexão quando o cliente abrir a tela de autorização.

Chaves de API: Chaves de API públicas gerenciadas pelo usuário ainda pertencem à API JSON e integrações via script. Conectores MCP usam OAuth em vez de configuração manual de token bearer.

Concessão

O Quilvo anuncia uma única concessão MCP OAuth: mcp:use. Aprová-la permite que o cliente use as ferramentas MCP disponíveis para sua conta Quilvo. O código das ferramentas ainda limita cada solicitação aos seus próprios dados.

Ferramentas

Ferramentas disponíveis

Uma conexão OAuth aprovada pode ver o conjunto completo de ferramentas MCP do Quilvo para o usuário autenticado.

Ferramenta	Grava	Finalidade
list-projects	Não	Lista os projetos do usuário com status, tipo, alvo, contagem atual e progresso.
get-project	Não	Lê um projeto com sessões de escrita recentes quando solicitado.
list-writing-sessions	Não	Lista sessões de escrita recentes e retorna totais para o intervalo selecionado.
log-writing-session	Sim	Cria uma sessão de escrita e atualiza a contagem atual do projeto.
list-characters	Não	Lista personagens de planejamento com papel, gancho, cor e projetos vinculados.
create-character	Sim	Cria um personagem (apenas o nome é obrigatório) e opcionalmente vincula um projeto.
update-character	Sim	Atualiza campos em um personagem existente.
list-codex-entries	Não	Lista entradas do codex de construção de mundo (locais, facções, itens, lore).
create-codex-entry	Sim	Cria uma entrada de codex de um tipo específico e opcionalmente vincula um projeto.
update-codex-entry	Sim	Atualiza campos em uma entrada de codex existente.
list-timeline	Não	Lista eventos da linha do tempo da história com datas em texto livre, tipo, projeto e personagens.
create-timeline-event	Sim	Cria um evento de linha do tempo (datas fictícias ou reais) e opcionalmente vincula personagens.
update-timeline-event	Sim	Atualiza um evento de linha do tempo existente e seus personagens vinculados.

Conectar

Configuração do cliente

A configuração do cliente MCP varia conforme o host, mas o valor necessário é o mesmo: a URL do servidor remoto. Clientes autenticados descobrem os metadados OAuth do Quilvo a partir desse endpoint. Use HTTPS em produção.

1. 01 Adicione o endpoint Use a URL HTTP MCP remota no conector hospedado ou no cliente MCP.
2. 02 Aprove o acesso Faça login no Quilvo e aprove a conexão OAuth para a única concessão mcp:use.
3. 03 Use as ferramentas Após a aprovação, o assistente pode listar as ferramentas MCP do Quilvo disponíveis para sua conta.

Valores de conexão

{
  "url": "https://quilvo.app/mcp/quilvo"
}

Alguns clientes MCP locais usam o armazenamento de certificados do Node. Se uma URL de desenvolvimento local falhar via HTTPS, use a URL HTTP local durante o desenvolvimento.

Exemplos

Argumentos das ferramentas

list-projects

Encontre projetos de rascunho ativos.

{
  "status": "drafting",
  "include_archived": false,
  "limit": 10
}

log-writing-session

Adicione 750 palavras a um projeto e mantenha o histórico de sessões intacto.

{
  "project_id": "9b7d4f6a-...",
  "word_count_action": "add",
  "word_count": 750,
  "date": "2026-05-24",
  "duration_minutes": 45,
  "notes": "Morning session."
}

log-writing-session

Defina o total do projeto quando um editor ou aplicativo de escrita souber a contagem mais recente. O Quilvo armazena apenas o delta de sessão calculado.

{
  "project_id": "9b7d4f6a-...",
  "word_count_action": "set_total",
  "word_count": 42100
}

MCP ou API

Use a superfície certa

Use MCP quando um assistente de IA precisar de uma superfície de ferramentas pequena e descobrível. Use a API JSON ao construir um aplicativo, script, importador ou integração que controle sua própria interface e fluxo de solicitações.