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:
- Abre Claude Code, escribe
/mcpy elige el servidornodale. - 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. - 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
callbackPorten 33418. Tras el inicio de sesión, el navegador vuelve ahttp://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.jsonde 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_configurationedita el borrador: solo cambian los campos que pasas, y una lista que pasas ocupa el lugar de la lista entera.publish_inbound_agent_configurationpone el borrador delante de los visitantes.discard_inbound_agent_configuration_draftvuelve 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 eldraftHashdevuelto porlist_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_textlee un texto de hasta 100 000 caracteres en segundo plano y devuelve undispatchId. Consultaget_knowledge_dispatchperiódicamente, y luego aplica o rechaza las propuestas. Lo que aplicas llega al borrador y todavía necesitapublish_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_uploadorequest_asset_uploaddevuelve un comandocurlque hay que ejecutar, válido durante 15 minutos. Después,add_documentoadd_assetregistra 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, yadd_assetsinstepsgastan créditos de IA.add_assetconstepsconserva tu narración tal como la enviaste y no gasta ninguno.
De cero a un agente en línea
me: comprueba la cuenta y el espacio de trabajo.- Conocimiento:
add_knowledge_quote, osubmit_knowledge_text, luegoget_knowledge_dispatchyapply_knowledge_proposals. Despuéslist_knowledge_quotesypublish_knowledge. - Opcional: competidores, documentos y recursos de demo, luego
publish_asset_catalog. - Ajustes:
update_inbound_agent_configuration,save_inbound_agent_outcome, luegopublish_inbound_agent_configuration. add_inbound_agent_site: declara el sitio.deploy_inbound_agent: pon el agente en línea.- Pega la etiqueta en el sitio, luego
get_inbound_agent_tag_statuspara 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_assetyanalyze_asset: 1 por segundo, 6 por minuto, 30 cada 15 minutos.request_document_uploadyadd_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.