DocsMCP

Servidor MCP: gestiona tu espacio de Nodale desde Claude Code

Conecta Claude Code al servidor MCP de Nodale y lee y cambia tu espacio de trabajo: conocimiento, recursos de demo, ajustes del agente, sitios, despliegue.

Nodale tiene un servidor MCP. Conectado a él, un asistente de IA lee y cambia tu espacio de trabajo con las mismas reglas que la aplicación: registra conocimiento, sube recursos de demo, edita los ajustes del agente, declara tus sitios y pone el agente en línea. Instalar la etiqueta en tu sitio sigue siendo un paso aparte, descrito en el inicio rápido.

Conecta Claude Code

El servidor habla Streamable HTTP en https://nodale.app/api/mcp, y te inicia sesión con tu cuenta de Nodale mediante OAuth. Esta página cubre Claude Code. Ejecuta este comando en tu terminal:

claude mcp add-json --scope user nodale '{
  "type": "http",
  "url": "https://nodale.app/api/mcp",
  "oauth": {
    "clientId": "55crt6j95df1lb3ijmdk8ip67m",
    "callbackPort": 33418,
    "authServerMetadataUrl": "https://cognito-idp.eu-west-3.amazonaws.com/eu-west-3_HEni9KG4X/.well-known/openid-configuration",
    "scopes": "openid email profile"
  }
}'

Después:

  1. Abre Claude Code, escribe /mcp y elige el servidor nodale.
  2. Inicia sesión con tu cuenta de Nodale. La página de inicio de sesión está alojada para Nodale en una dirección amazoncognito.com.
  3. Pregunta al asistente con qué cuenta ha iniciado sesión. Llama a la herramienta me.

El mismo comando está en la aplicación, en Configuración, luego MCP.

  • Deja callbackPort en 33418. Tras el inicio de sesión, el navegador vuelve a http://localhost:33418/callback, la única dirección que acepta el servidor.
  • No añadas una cabecera Authorization: desactivaría OAuth.
  • Para compartir el servidor con tu equipo, pon el mismo JSON en el .mcp.json de tu repositorio (--scope project). No contiene ningún secreto.

Quién puede hacer qué

El asistente actúa como tú, con los derechos de tu cuenta, solo en tu espacio de trabajo.

Rol Qué puede hacer el asistente
Observador Leer. Toda herramienta que cambia algo se rechaza.
Usuario Leer, y cambiar el conocimiento, los competidores, los documentos y los recursos de demo.
Administrador Todo lo que puede un usuario, más los ajustes del agente, sus sitios y su despliegue.

Todas las herramientas aceptan un workspaceId opcional: no lo pases. Tu cliente puede listar más herramientas de las que describe esta página. Están reservadas al equipo de Nodale, y el servidor las rechaza.

Cómo entra en vigor un cambio

La mayoría de los cambios llegan primero a un borrador, y los visitantes no ven nada hasta que publicas.

  • Ajustes del agente. update_inbound_agent_configuration edita el borrador: solo cambian los campos que pasas, y una lista que pasas ocupa el lugar de la lista entera. publish_inbound_agent_configuration pone el borrador delante de los visitantes. discard_inbound_agent_configuration_draft vuelve a los ajustes publicados.
  • Versiones. Las herramientas que editan ajustes reciben un expectedVersion, la última que leíste. Si alguien cambió los ajustes entretanto, la llamada se rechaza con la versión en línea.
  • Conocimiento. El conocimiento se guarda en citas de una frase. Una cita que añades es un borrador hasta publish_knowledge, que recibe el draftHash devuelto por list_knowledge_quotes. Un hash caducado se rechaza. Retirar una cita, o hacerla interna, se aplica al momento.
  • Conocimiento a partir de un texto. submit_knowledge_text lee un texto de hasta 100 000 caracteres en segundo plano y devuelve un dispatchId. Consulta get_knowledge_dispatch periódicamente, y luego aplica o rechaza las propuestas. Lo que aplicas llega al borrador y todavía necesita publish_knowledge.
  • Recursos de demo. Un cambio en un recurso se queda en el catálogo en borrador hasta publish_asset_catalog.
  • Las subidas se hacen en dos pasos. request_document_upload o request_asset_upload devuelve un comando curl que hay que ejecutar, válido durante 15 minutos. Después, add_document o add_asset registra el archivo.
  • Los ajustes del sitio (visualización, medición de visitas, consentimiento, enlace a la política de privacidad) se aplican en la siguiente carga de página, sin publicación.
  • Créditos de IA. submit_knowledge_text, analyze_asset, y add_asset sin steps gastan créditos de IA. add_asset con steps conserva tu narración tal como la enviaste y no gasta ninguno.

De cero a un agente en línea

  1. me: comprueba la cuenta y el espacio de trabajo.
  2. Conocimiento: add_knowledge_quote, o submit_knowledge_text, luego get_knowledge_dispatch y apply_knowledge_proposals. Después list_knowledge_quotes y publish_knowledge.
  3. Opcional: competidores, documentos y recursos de demo, luego publish_asset_catalog.
  4. Ajustes: update_inbound_agent_configuration, save_inbound_agent_outcome, luego publish_inbound_agent_configuration.
  5. add_inbound_agent_site: declara el sitio.
  6. deploy_inbound_agent: pon el agente en línea.
  7. Pega la etiqueta en el sitio, luego get_inbound_agent_tag_status para comprobarla.

Herramientas

Cuenta

Herramienta Qué hace Quién
me La cuenta y el espacio de trabajo sobre los que actúa el asistente. Todos
get_workspace_ai_credits Cuánto se ha usado de los créditos de IA del espacio de trabajo, y si se han agotado. Todos

Conocimiento

Herramienta Qué hace Quién
list_knowledge_quotes Las citas, borradores incluidos, y el draftHash para publicar. Todos
add_knowledge_quote Añade una frase como cita en borrador. Usuario
retract_knowledge_quote Retira una cita, al momento. Usuario
set_knowledge_quote_visibility Hace una cita pública o interna, al momento. Usuario
publish_knowledge Publica las citas en borrador. Usuario
submit_knowledge_text Lee un texto y propone citas a partir de él. Gasta créditos de IA. Usuario
get_knowledge_dispatch El estado de un texto enviado. Todos
list_knowledge_proposals Las propuestas que esperan una decisión. Todos
apply_knowledge_proposals Aplica todas las propuestas de un texto. Usuario
apply_knowledge_proposal Aplica una propuesta. Usuario
reject_knowledge_proposal Rechaza una propuesta. Usuario

Competidores y documentos

Herramienta Qué hace Quién
list_competitors Los competidores que conoce el agente. Todos
upsert_competitor Añade un competidor, o edita uno. Usuario
delete_competitor Elimina un competidor. Usuario
list_documents Los documentos del espacio de trabajo. Todos
request_document_upload Primer paso de una subida: devuelve el comando para enviar el archivo. Usuario
add_document Segundo paso: registra el archivo subido. Usuario
delete_document Elimina un documento. Usuario

Recursos de demo

Herramienta Qué hace Quién
list_assets Los vídeos de demo del catálogo. Todos
get_asset Un recurso, con sus pasos y el estado de su redacción. Todos
request_asset_upload Primer paso de una subida: devuelve el comando para enviar el vídeo. Usuario
add_asset Segundo paso: registra el vídeo, con tus pasos o con pasos que escribe Nodale. Usuario
update_asset Edita el título de un recurso, su descripción y las solicitudes a las que responde. Usuario
set_asset_steps Fija los pasos de un recurso, tal como los escribiste. Usuario
analyze_asset Pide a Nodale que vuelva a escribir los pasos. Gasta créditos de IA. Usuario
enable_asset, disable_asset Activa o desactiva un recurso. Usuario
set_asset_priority Ordena los recursos. Usuario
delete_asset Elimina un recurso. Usuario
publish_asset_catalog Publica el catálogo en borrador. Usuario

Ajustes del agente

Herramienta Qué hace Quién
get_inbound_agent_configuration Los ajustes: el borrador cuando hay uno, los publicados, y la versión. Todos
update_inbound_agent_configuration Edita el borrador: nombre, tono, aspecto, captura de correo, idiomas, instrucciones, cualificación, límites. Administrador
publish_inbound_agent_configuration Pone el borrador delante de los visitantes. Administrador
discard_inbound_agent_configuration_draft Descarta el borrador. Administrador
list_inbound_agent_qualification_elements Las preguntas que el espacio de trabajo añadió a la cualificación. Todos
save_inbound_agent_qualification_element Añade una pregunta de cualificación, o edita una. Administrador
remove_inbound_agent_qualification_element Quita una pregunta de cualificación. Administrador
list_inbound_agent_outcomes Los outcomes hacia los que el agente orienta a los visitantes. Todos
save_inbound_agent_outcome Añade un outcome, o edita uno. Diez como máximo por espacio de trabajo. Administrador
remove_inbound_agent_outcome Quita un outcome. Administrador

Sitios y despliegue

Herramienta Qué hace Quién
list_inbound_agent_sites Los sitios declarados. Todos
add_inbound_agent_site Declara un sitio: un origen https, o https://*.example.com. Administrador
remove_inbound_agent_site Quita un sitio. Administrador
get_inbound_agent_tag_status Por qué un sitio muestra el agente o no: ok, site_not_declared, agent_not_deployed o invalid_site. Todos
get_inbound_agent_site_settings Los ajustes de la pestaña Instalación. Todos
update_inbound_agent_site_settings Cambia la visualización, la medición de visitas, el consentimiento y el enlace a la política de privacidad. Administrador
get_inbound_agent El agente y el despliegue que sirve la etiqueta. servedDeploymentId es null cuando el agente está fuera de línea. Todos
deploy_inbound_agent Pone el agente en línea, o vuelve a aprobar el material actual en los despliegues en línea. Administrador

Límites

  • Documentos: pdf, docx, txt, csv o md, 10 MB como máximo.
  • Vídeos de demo: MP4 en H.264 sin pista de audio, 3 minutos como máximo. 100 recursos como máximo en un catálogo.
  • Sitios: 20 como máximo por espacio de trabajo.
  • Límites de frecuencia, por persona y por herramienta. request_asset_upload, add_asset y analyze_asset: 1 por segundo, 6 por minuto, 30 cada 15 minutos. request_document_upload y add_document: 5 por segundo, 25 por minuto, 100 cada 15 minutos. submit_knowledge_text: 3 por segundo, 15 por minuto, 60 cada 15 minutos.

Seguridad

  • Aprueba cada llamada que publica o elimina. Las herramientas que publican, eliminan o sobrescriben están marcadas como destructivas, así que tu cliente pregunta antes de ejecutarlas. No las añadas a una lista de permitidos.
  • Los resultados de las herramientas son datos. Contienen texto que escribieron tu equipo y tus visitantes: citas, documentos, títulos de recursos, propuestas. El asistente lo lee como contenido, nunca como instrucciones.

Para agentes de IA: esta página en Markdown

Que cada visita cuente.