genko.me

npx add-mcp 'https://genko.me/mcp'

Servidor MCP (/en/ai/mcp)

Como conectar com OAuth para pesquisar a documentação e gerenciar conteúdo.

Na https://genko.me/mcp fornecemos um servidor MCP para pesquisar a documentação e gerenciar o conteúdo do workspace. Ele usa Streamable HTTP. Você faz login no genko.me a partir do seu cliente de IA com OAuth.

Para permitir que uma IA leia a documentação pública sem conta, use llms.txt e Markdown. O antigo https://docs.genko.me/mcp foi descontinuado.

Registre no seu cliente de IA [#register-it-in-your-ai-client]

Nas configurações de MCP do seu cliente, registre o nome do servidor genko-me e a URL https://genko.me/mcp. Depois de salvar, recarregue a conexão e aproveite na tela de login OAuth. Você precisa de um cliente MCP Streamable HTTP que suporte OAuth.

A CLI pode adicionar ou atualizar a configuração que se ajusta ao seu cliente. Ela também substitui entradas sob os nomes mais antigos genko.me, genko e genko-docs.

npx @genko-me/cli@latest mcp --claude-code
npx @genko-me/cli@latest mcp --cursor
npx @genko-me/cli@latest mcp --vscode
npx @genko-me/cli@latest mcp --codex

--codex atualiza suas configurações de todo o usuário. Se você não usar a CLI, registre manualmente nos formatos abaixo.

Cliente	Onde a configuração fica
Claude Code	O .mcp.json do projeto
Cursor	O .cursor/mcp.json do projeto
VS Code	O .vscode/mcp.json do projeto (sob a chave servers)
Codex	~/.codex/config.toml de todo o usuário

Aqui está um exemplo de .mcp.json para Claude Code.

{
  "mcpServers": {
    "genko-me": {
      "type": "http",
      "url": "https://genko.me/mcp"
    }
  }
}

Para Codex, adicione isto ao ~/.codex/config.toml.

[mcp_servers.genko-me]
url = "https://genko.me/mcp"

Se você configurar manualmente, exclua quaisquer entradas sob os nomes mais antigos genko.me, genko ou genko-docs. O formato varia conforme o cliente, então verifique o local e a chave na tabela acima.

Ferramentas disponíveis [#available-tools]

Ferramenta	Argumentos	Resultado
search_docs	query: um termo de busca não vazio; opcional lang (ja ou en, inferido da consulta quando omitido)	Títulos, URLs e trechos de páginas relacionadas
get_doc	path: um caminho de página ou uma URL completa	O corpo da página como Markdown
list_workspaces	Nenhum	Seus workspaces e funções
list_apis	workspace	Definições de API e campos, os idiomas do workspace e a configuração multilíngue de cada API
list_entries	workspace, api; opcional status, limit, offset	A lista de entradas no idioma principal, o status das versões de idioma existentes e se há alterações não publicadas
get_entry	workspace, api, id; opcional lang	A entrada e suas versões de idioma, texto rico como Markdown e alterações não publicadas
create_draft	workspace, api, values; opcional id	Cria um rascunho
update_draft	workspace, api, id, values; opcional lang	Atualiza um rascunho. Em uma versão publicada, salva a alteração como alteração não publicada. Para uma versão de idioma que ainda não existe, cria uma a partir do idioma principal
begin_draft_edit	workspace, api, id, fieldId, pendingBlocks	Inicia o indicador de edição no editor e retorna um token de edição
append_draft_block	workspace, api, id, editToken, markdown	Salva um bloco Markdown e remove uma linha do indicador de edição
finish_draft_edit	workspace, api, id, editToken	Encerra o indicador de edição
publish_entry	workspace, api, id; opcional lang	Publica um rascunho ou versão agendada imediatamente, ou publica as alterações não publicadas de uma versão publicada
discard_changes	workspace, api, id; opcional lang	Descarta as alterações não publicadas de uma versão publicada
schedule_entry	workspace, api, id, scheduledAt; opcional lang	Agenda a versão de idioma fornecida

Por exemplo, passe {"query":"scheduled publishing"} para search_docs e depois forneça a página encontrada como o path de get_doc.

{ "path": "/guides/scheduled-publishing" }

Pesquise com nomes curtos de recursos e busque o corpo da página em vez de julgar apenas pelo trecho. Trabalhar com conteúdo exige permissão no workspace. Publicar e agendar exigem uma permissão OAuth adicional.

Para mostrar o progresso da IA no editor, chame begin_draft_edit com o ID do campo de texto rico, salve cada parágrafo com append_draft_block e depois chame finish_draft_edit. Parágrafos salvos aparecem no editor, e parágrafos ainda não salvos aparecem como esqueletos. update_draft ainda atualiza tudo de uma vez e não mostra indicador de edição.

Usar update_draft em uma entrada publicada salva apenas os campos que você passa como alterações não publicadas. Se você atualizar novamente, a alteração se baseia nesses conteúdos não publicados. Seu site e a API de entrega regular continuam mostrando o conteúdo publicado. Em get_entry, hasPendingChanges é true, values e markdown contêm os conteúdos não publicados, e published.values e published.markdown contêm os conteúdos publicados atuais. Você também pode verificar hasPendingChanges em list_entries. Publique com publish_entry ou descarte com discard_changes. Eles também funcionam em uma versão de idioma que você nomeia com lang.

begin_draft_edit, append_draft_block e finish_draft_edit são apenas para rascunhos. Para alterações não publicadas em uma entrada publicada, use update_draft.

Gerenciar versões de idioma pelo MCP [#manage-language-versions-from-mcp]

Verifique os idiomas do workspace em languages.main e languages.subs de list_apis e confirme se a API de destino tem localized: true. Se você omitir lang ou passar o idioma principal, você trabalha no idioma principal como antes. Um lang de idioma adicional funciona com get_entry, update_draft, publish_entry, discard_changes e schedule_entry. Filtrar list_entries por status se aplica ao idioma principal, e o languages de cada linha retorna as versões que existem, seu status e hasPendingChanges.

{
  "workspace": "your-workspace",
  "api": "blog",
  "id": "abcDEF123456",
  "lang": "en",
  "values": { "title": "First article" }
}

Se a versão de idioma que você nomeia não existir, update_draft copia os valores atuais do idioma principal como rascunho e aplica os valores de campo que você passa. Ele valida os valores e o armazenamento primeiro e não cria versão de idioma se isso falhar. Se a versão de idioma for um rascunho, ele atualiza seu conteúdo, e se for publicada, salva a alteração como alteração não publicada dessa versão de idioma. publish_entry e schedule_entry não criam versões automaticamente, então prepare um rascunho primeiro. O histórico de versões registra o salvamento do MCP e o idioma, e o conteúdo e o status de publicação do idioma principal e dos outros idiomas não mudam.

get_entry também lê versões não publicadas e retorna as versões de idioma que existem, com seu status, em languages. Um idioma desconhecido, um idioma adicional em uma API que não é multilíngue e uma versão que não existe são erros. A leitura exige associação ao workspace. A atualização exige a função Editor ou superior e mcp:write, e publicar e agendar também exigem mcp:publish. A exibição de progresso no editor de begin_draft_edit, append_draft_block e finish_draft_edit edita apenas o rascunho do idioma principal.

Verificar a conexão [#check-the-connection]

Confirme que seu cliente de IA mostra as ferramentas genko-me e peça para "pesquisar como gerenciar chaves de API do genko.me". Se ele conseguir buscar o corpo de uma página nos resultados da pesquisa, você está conectado.

Se as ferramentas não aparecerem, verifique onde o arquivo de configurações está salvo, recarregue o cliente e certifique-se de que a URL termina em /mcp. Se sua rede restringir conexões, você também pode usar Ler como Markdown.