KnowMapped MCP

Conecta un cliente de IA a KnowMapped.

Con Professional, conecta un cliente de IA compatible con tu cuenta de KnowMapped. Pídele que encuentre un mapa, cree uno, edite conceptos y relaciones, o publique una instantánea pública completada.

Encuentra, crea, edita y publica mapas mediante conversación.

A través de MCP, un cliente de IA puede leer y cambiar conceptos individuales, conexiones, detalles del mapa y diseños. Utiliza los permisos de tu cuenta de KnowMapped conectada.

01

Encuentra y recupera

Busca los mapas disponibles para tu cuenta y solicita representaciones completas, compactas o resumidas.

02

Crea y amplía

Prepara un mapa, revisa el cargo de un crédito y confirma la creación. Añade hallazgos a mapas existentes.

03

Publica y actualiza

Haz que los mapas sean públicos o privados, publica ediciones completadas como instantáneas públicas y verifica el estado de entrega.

04

Edita y organiza

Añade, revisa, conecta, elimina y diseña el contenido del mapa con validación antes de aplicar los cambios.

1. 01

   Configura el servidor de recursos

   Configura un servidor HTTP Streamable remoto con https://mcp.knowmapped.com/mcp. Las operaciones autenticadas utilizan una respuesta 401 y un desafío WWW-Authenticate cuando se requiere autorización. El descubrimiento de herramientas puede estar disponible antes de iniciar sesión.
2. 02

   Resuelve los metadatos OAuth

   Sigue el desafío hasta los metadatos del recurso protegido, resuelve su servidor de autorización y lee los metadatos del servidor de autorización. Aquí es donde el cliente aprende los endpoints, ámbitos, método PKCE y opciones de registro.
3. 03
4. 04

   Autoriza con PKCE

   Genera un verificador y desafío PKCE S256, abre la solicitud de autorización en el navegador, luego inicia sesión y aprueba los ámbitos de mapa solicitados. Las credenciales permanecen en el flujo del navegador de KnowMapped.
5. 05

   Inicializa y carga herramientas

   Intercambia el código de autorización con el verificador y el enlace de recursos, envía el token de portador a https://mcp.knowmapped.com/mcp, luego ejecuta la inicialización de MCP y tools/list. Actualiza las herramientas del cliente o inicia una nueva conversación después de conectarte.

Usa KnowMapped con ChatGPT o Codex.

ChatGPT

Añade una aplicación personalizada.

Abre los Plugins de ChatGPT, selecciona el botón más y luego Añadir servidor MCP personalizado. Ingresa https://mcp.knowmapped.com/mcp y elige autenticación OAuth. Completa el flujo de consentimiento del navegador de KnowMapped, instala el plugin resultante e invócalo en un nuevo chat. Actualiza sus herramientas después de una actualización del servidor.

Lee la guía de plugins MCP de OpenAI

Codex

Añade un servidor MCP remoto.

Registra el endpoint HTTP Streamable, luego ejecuta el comando de inicio de sesión separado para que Codex pueda completar el flujo OAuth basado en navegador y almacenar en caché las credenciales resultantes.

codex mcp add knowmapped --url https://mcp.knowmapped.com/mcp
codex mcp login knowmapped
codex mcp list

Lee la guía MCP de Codex de OpenAI

Los permisos de tu cuenta siguen aplicándose.

Cada solicitud está limitada por el acceso a mapas existente de la cuenta conectada. Un enlace público no otorga permiso de edición, y un cliente no puede eludir los controles de propiedad o uso compartido.

La creación de mapas MCP requiere Professional o una prueba activa de Professional. Cada mapa creado exitosamente utiliza 1 crédito de generación. La verificación previa muestra el costo y el saldo restante; el cliente debe pedirte que confirmes antes de cobrar. La validación fallida no utiliza créditos. Leer, editar, verificar el estado de publicación y publicar mapas existentes no utilizan créditos de creación.

Editar y publicar tienen permisos separados. Aprueba maps:write para ediciones de contenido y maps:publish para instantáneas públicas y cambios de visibilidad. Las conexiones existentes deben solicitar un nuevo consentimiento para obtener acceso de publicación.

Las conexiones no tienen caducidad programada de credenciales de actualización en la implementación estándar. Los clientes renuevan automáticamente los tokens de acceso de corta duración y deben guardar cada credencial de actualización rotada. La revocación, los cambios de contraseña, las restricciones de cuenta o la pérdida de credenciales de actualización pueden requerir reconexión.

Desconecta la integración de tu cliente para eliminar su conexión local. También puedes revocar el acceso OAuth desde KnowMapped cuando necesites invalidar una autorización existente.

Publica cuando las ediciones estén listas.

Pide al agente que termine de editar y luego publica. Las ediciones ordinarias dejan la instantánea pública existente sin cambios. La primera publicación utiliza set_knowmapped_map_visibility y requiere tu permiso explícito y confirmación de que tienes derecho a publicar.

Para un mapa ya público, publish_knowmapped_map reemplaza la instantánea pública con el borrador completado. KnowMapped genera su vista previa pública y aplica la misma moderación, restricciones, bloqueos y permisos que la publicación en el navegador.

Ambas acciones necesitan el expected_revision actual y un idempotency_key único de 1 a 200 caracteres. Después de un tiempo de espera, reintenta con la misma clave y argumentos idénticos. Una solicitud modificada necesita una clave nueva. Los resultados confirmados se pueden recuperar durante 30 días sin repetir la publicación ni deshacer cambios de visibilidad posteriores.

Usa get_knowmapped_publication_status para verificar la revisión publicada, la moderación y la entrega. Una instantánea guardada puede estar aún pendiente de entrega, y una revisión pendiente no es una publicación exitosa. Las diferencias de revisión significan que el contenido puede haber cambiado; los cambios operativos también avanzan las revisiones.

Para eliminar el acceso público, pide al agente que haga el mapa privado. Esto elimina la instantánea pública, desactiva la visualización en vivo y pone en cola la eliminación de la página pública y la vista previa. Las copias descargadas previamente permanecen fuera del control de KnowMapped.

Descubrimiento, autorización y herramientas.

El servidor sigue las convenciones de descubrimiento de MCP Streamable HTTP y OAuth. Los clientes deben comenzar con el endpoint MCP en lugar de configurar endpoints de autorización manualmente.

Descubrimiento

Endpoint MCP

https://mcp.knowmapped.com/mcp

Recurso protegido

https://mcp.knowmapped.com/.well-known/oauth-protected-resource/mcp

Servidor de autorización

https://app.knowmapped.com

OAuth

Concesión

Código de autorización con PKCE S256

Registro de cliente

Documentos de metadatos de ID de cliente, con respaldo de Registro Dinámico de Clientes

Recurso

https://mcp.knowmapped.com/mcp

Ámbito	Propósito
maps:read	Buscar y recuperar mapas disponibles para la cuenta conectada.
maps:create	Verificación previa, confirmación, creación y recuperación de resultados de creación de mapas.
maps:write	Validar y aplicar ediciones a mapas donde la cuenta tiene acceso de edición.
maps:publish	Hacer públicos o privados los mapas editables, publicar instantáneas públicas y verificar el estado de publicación. No otorga edición de contenido.

Lee resource://knowmapped/capabilities para límites, costos de creación y el contrato de herramientas actual. La recuperación admite valores independientes de node_offset y edge_offset, con page_size hasta 200. Las solicitudes de resumen cargan recuentos sin contenido de gráfico; las solicitudes paginadas cargan solo las filas solicitadas. Compara revisiones entre páginas y reinicia si cambian.

Herramientas actuales

search_knowmapped_maps

Busca en la biblioteca de mapas autorizada.

get_knowmapped_map

Recupera páginas completas o compactas, o recuentos de resumen sin gráfico.

get_knowmapped_map_adjacency

Inspecciona el vecindario de un concepto por ID o etiqueta única exacta.

get_knowmapped_layout_summary

Inspecciona los límites del diseño y las estadísticas de superposición.

preflight_knowmapped_map_creation

Verifica elegibilidad, créditos y un borrador de gráfico retenido.

create_knowmapped_map

Valida o prepara la creación; el uso de crédito requiere confirmación explícita.

confirm_knowmapped_map_creation

Confirma un borrador retenido y liquida su cargo de creación de un crédito.

get_knowmapped_map_creation_result

Recupera un resultado de creación después de una respuesta interrumpida.

get_knowmapped_update_schema

Obtén el esquema de operación autoritativo antes de construir ediciones.

update_knowmapped_map

Valida o aplica un parche de gráfico atómico y seguro para revisiones.

set_knowmapped_map_visibility

Haz un mapa público o privado; la primera publicación crea una instantánea.

publish_knowmapped_map

Publica o republica ediciones completadas en un mapa ya público.

get_knowmapped_publication_status

Verifica la revisión de la instantánea, la moderación y la entrega sin descargar el gráfico.

Comienza con la actualización de herramientas del cliente.

Las herramientas no aparecen

Actualiza las herramientas de la integración y comienza una nueva conversación. Una conversación existente puede conservar la lista de herramientas que recibió al inicio.

El inicio de sesión no se abre

Desconecta y vuelve a conectar KnowMapped en el cliente. Confirma que el cliente admite OAuth para servidores MCP remotos.

Un mapa no se puede cambiar

Confirma que la conexión tiene maps:write y que tu cuenta puede editar el mapa. Recupera su revisión actual y verifica si está bloqueado.

La publicación no está disponible

Solicita maps:publish y aprueba un nuevo consentimiento. Actualiza el descubrimiento de herramientas. Tu cuenta aún necesita acceso de edición; la moderación o las restricciones de publicación pueden impedir la publicación.

Se perdió una respuesta de publicación

Reintenta la solicitud idéntica con su clave original y luego verifica el estado de publicación. Usa una clave nueva solo para una solicitud nueva.

Una conexión necesita iniciar sesión nuevamente

Verifica si se revocó el acceso o si el cliente perdió una credencial de actualización rotada. Las credenciales de actualización no tienen caducidad programada en la implementación estándar, pero los clientes deben renovarlas y guardarlas correctamente.