genko.me

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

Servidor MCP (/en/ai/mcp)

Cómo conectarse con OAuth para buscar en la documentación y gestionar contenido.

En https://genko.me/mcp proporcionamos un servidor MCP para buscar en la documentación y gestionar el contenido del espacio de trabajo. Utiliza Streamable HTTP. Inicias sesión en genko.me desde tu cliente de IA con OAuth.

Para permitir que una IA lea la documentación pública sin una cuenta, usa llms.txt y Markdown. El antiguo https://docs.genko.me/mcp ha sido retirado.

Regístralo en tu cliente de IA [#register-it-in-your-ai-client]

En la configuración de MCP de tu cliente, registra el nombre del servidor genko-me y la URL https://genko.me/mcp. Después de guardar, recarga la conexión y aprueba la pantalla de inicio de sesión de OAuth. Necesitas un cliente MCP de Streamable HTTP que admita OAuth.

La CLI puede añadir o actualizar la configuración que se ajusta a tu cliente. También reemplaza las entradas bajo los nombres antiguos genko.me, genko y 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 actualiza la configuración a nivel de usuario. Si no usas la CLI, regístralo manualmente en los formatos siguientes.

Cliente	Dónde va la configuración
Claude Code	El .mcp.json del proyecto
Cursor	El .cursor/mcp.json del proyecto
VS Code	El .vscode/mcp.json del proyecto (bajo la clave servers)
Codex	~/.codex/config.toml a nivel de usuario

Aquí tienes un ejemplo de .mcp.json para Claude Code.

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

Para Codex, añade esto a ~/.codex/config.toml.

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

Si lo configuras manualmente, elimina cualquier entrada bajo los nombres antiguos genko.me, genko o genko-docs. El formato varía según el cliente, así que consulta la ubicación y la clave en la tabla anterior.

Herramientas disponibles [#available-tools]

Herramienta	Argumentos	Resultado
search_docs	query: un término de búsqueda no vacío; opcional lang (ja o en, inferido de la consulta si se omite)	Títulos, URLs y extractos de páginas relacionadas
get_doc	path: una ruta de página o una URL completa	El cuerpo de la página como Markdown
list_workspaces	Ninguno	Tus espacios de trabajo y roles
list_apis	workspace	Definiciones de API y campos, los idiomas del espacio de trabajo y la configuración multilingüe de cada API
list_entries	workspace, api; opcional status, limit, offset	La lista de entradas en el idioma principal, el estado de las versiones de idioma existentes y si hay cambios sin publicar
get_entry	workspace, api, id; opcional lang	La entrada y sus versiones de idioma, texto enriquecido como Markdown y cambios sin publicar
create_draft	workspace, api, values; opcional id	Crea un borrador
update_draft	workspace, api, id, values; opcional lang	Actualiza un borrador. En una versión publicada, guarda el cambio como un cambio sin publicar. Para una versión de idioma que aún no existe, crea una a partir del idioma principal
begin_draft_edit	workspace, api, id, fieldId, pendingBlocks	Inicia el indicador de edición en el editor y devuelve un token de edición
append_draft_block	workspace, api, id, editToken, markdown	Guarda un bloque de Markdown y elimina una línea del indicador de edición
finish_draft_edit	workspace, api, id, editToken	Finaliza el indicador de edición
publish_entry	workspace, api, id; opcional lang	Publica un borrador o una versión programada de inmediato, o publica los cambios sin publicar de una versión publicada
discard_changes	workspace, api, id; opcional lang	Descarta los cambios sin publicar de una versión publicada
schedule_entry	workspace, api, id, scheduledAt; opcional lang	Programa la versión de idioma indicada

Por ejemplo, pasa {"query":"scheduled publishing"} a search_docs, y luego dale la página que encuentre como path de get_doc.

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

Busca con nombres de funciones cortos y obtén el cuerpo de la página en lugar de juzgar solo por el extracto. Trabajar con contenido requiere permiso en el espacio de trabajo. Publicar y programar requieren un permiso adicional de OAuth.

Para mostrar el progreso de la IA en el editor, llama a begin_draft_edit con el ID del campo de texto enriquecido, guarda cada párrafo con append_draft_block y luego llama a finish_draft_edit. Los párrafos guardados aparecen en el editor, y los párrafos aún no guardados se muestran como esqueletos. update_draft aún actualiza todo de una vez y no muestra indicador de edición.

Usar update_draft en una entrada publicada guarda solo los campos que pasas como cambios sin publicar. Si actualizas de nuevo, el cambio se basa en esos contenidos sin publicar. Tu sitio y la API de entrega regular siguen mostrando el contenido publicado. En get_entry, hasPendingChanges es true, values y markdown contienen los contenidos sin publicar, y published.values y published.markdown contienen los contenidos publicados actuales. También puedes consultar hasPendingChanges en list_entries. Publica con publish_entry o descarta con discard_changes. Estos también funcionan en una versión de idioma que indiques con lang.

begin_draft_edit, append_draft_block y finish_draft_edit son solo para borradores. Para cambios sin publicar en una entrada publicada, usa update_draft.

Gestionar versiones de idioma desde MCP [#manage-language-versions-from-mcp]

Consulta los idiomas del espacio de trabajo en languages.main y languages.subs de list_apis, y confirma que la API de destino tiene localized: true. Si omites lang o pasas el idioma principal, trabajas en el idioma principal como antes. Un lang de idioma adicional funciona con get_entry, update_draft, publish_entry, discard_changes y schedule_entry. Filtrar list_entries por status se aplica al idioma principal, y el languages de cada fila devuelve las versiones que existen, su estado y hasPendingChanges.

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

Si la versión de idioma que indicas no existe, update_draft copia los valores actuales del idioma principal como borrador y aplica los valores de campo que pasas. Primero valida los valores y el almacenamiento, y no crea ninguna versión de idioma si eso falla. Si la versión de idioma es un borrador, actualiza su contenido, y si está publicada, guarda el cambio como cambio sin publicar de esa versión de idioma. publish_entry y schedule_entry no crean versiones automáticamente, así que prepara un borrador primero. El historial de versiones registra el guardado desde MCP y el idioma, y los contenidos y el estado de publicación del idioma principal y de los demás idiomas no cambian.

get_entry también lee versiones sin publicar y devuelve las versiones de idioma que existen, con su estado, en languages. Un idioma desconocido, un idioma adicional en una API que no es multilingüe y una versión que no existe son errores. Leer requiere ser miembro del espacio de trabajo. Actualizar requiere el rol de Editor o superior y mcp:write, y publicar y programar también requieren mcp:publish. La visualización de progreso en el editor de begin_draft_edit, append_draft_block y finish_draft_edit edita solo el borrador del idioma principal.

Comprobar la conexión [#check-the-connection]

Confirma que tu cliente de IA muestra las herramientas de genko-me y luego pídele que "busque cómo gestionar las claves de API de genko.me". Si puede obtener el cuerpo de una página de los resultados de búsqueda, estás conectado.

Si las herramientas no aparecen, verifica dónde se guarda el archivo de configuración, recarga el cliente y asegúrate de que la URL termine en /mcp. Si tu red restringe las conexiones, también puedes usar Leer como Markdown.