# Servidor MCP: gestiona tu espacio de Nodale desde Claude Code

<https://nodale.ai/es/docs/mcp>

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](https://nodale.ai/es/docs).

## 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:

```bash
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](https://nodale.ai/es/docs) 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.

## Docs

- [Instala el agente de Nodale en tu web](https://nodale.ai/es/docs): Una sola etiqueta script pone el agente de Nodale en tu web. Dónde pegarla, qué debe permitir tu web y cómo comprobar que funciona. (Markdown: https://nodale.ai/es/docs.md)
- [API de JavaScript: abre el agente de Nodale desde tu código](https://nodale.ai/es/docs/api): Los comandos nodale() que una página puede llamar: abrir el agente desde tu botón o formulario, pasar un correo y contexto, comunicar el consentimiento. (Markdown: https://nodale.ai/es/docs/api.md)
