> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/cli/es/guias/ai-agents/connect-mcp.md).

# Conectar un cliente de IA con MCP

Añadir el servidor MCP de Devolutions CLI a Claude Code, GitHub Copilot u otro cliente MCP, y entender qué puede ver y hacer el modelo.

`devo mcp` convierte Devolutions CLI en un servidor Model Context Protocol (MCP). Su cliente de IA lo inicia, y el modelo obtiene herramientas para trabajar en su espacio de trabajo: enumerar bóvedas, buscar entradas, revisar el acceso, generar contraseñas y más. Es el mismo espacio de trabajo y los mismos permisos que los comandos `devo` que usted ejecuta.

## Antes de empezar

* Devolutions CLI está instalado, y el comando `devo` está en el `PATH` del cliente de IA.
* Ha iniciado sesión. El servidor MCP no tiene una herramienta de inicio de sesión: usa los contextos que guardó con `devo login`, empezando por el actual. Consulte [Conectarse a sus espacios de trabajo](/cli/es/guias/connect.md).
* Su cliente MCP puede iniciar un servidor local por la entrada y la salida estándar (stdio), lo que hacen la mayoría de los clientes.

{% hint style="warning" %}
El servidor MCP puede devolver un valor de secreto a su cliente de IA, a través de la herramienta `RDM_resolve_secret_reference`. Todo lo que recibe el cliente puede llegar al modelo y a su transcripción. Si el modelo no necesita los valores, inicie el servidor con `--deny-tool RDM_resolve_secret_reference`. Consulte [Limitar lo que puede hacer un agente](/cli/es/guias/ai-agents/limit-tools.md).
{% endhint %}

## Añada el servidor a su cliente

La mayoría de los clientes MCP describen un servidor local con un comando y sus argumentos. Añada una entrada como esta a la configuración MCP de su cliente:

```json
{
  "mcpServers": {
    "devolutions": {
      "command": "devo",
      "args": ["mcp", "--deny-tool", "RDM_resolve_secret_reference"]
    }
  }
}
```

La clave que contiene los servidores (`mcpServers` aquí) y el archivo donde va dependen de su cliente. Consulte la documentación de su cliente para saber dónde añadir un servidor stdio local.

Reinicie el cliente o vuelva a cargar sus servidores MCP. El cliente inicia `devo mcp` por su cuenta y lo detiene cuando termina la sesión: usted no lo ejecuta en un terminal.

### Opciones que puede añadir

<table><thead><tr><th width="260">OPCIÓN</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>--context &#x3C;context-name></code></td><td>Usa este contexto guardado en lugar del actual. Útil cuando el agente debe trabajar en un solo espacio de trabajo.</td></tr><tr><td><code>--read-only</code>, <code>--deny-destructive</code>, <code>--deny-open-world</code>, <code>--allow-tool</code>, <code>--deny-tool</code></td><td>Limite las herramientas que obtiene el modelo. Consulte <a href="/cli/es/guias/ai-agents/limit-tools.md">Limitar lo que puede hacer un agente</a>.</td></tr><tr><td><code>--server-name &#x3C;name></code></td><td>Nombre del servidor enviado al cliente cuando se conecta. El valor predeterminado es <code>Remote Desktop Manager Devo CLI MCP Server</code>.</td></tr></tbody></table>

Por ejemplo, para dar a un agente acceso de solo lectura a un solo espacio de trabajo:

```json
{
  "mcpServers": {
    "devolutions": {
      "command": "devo",
      "args": ["mcp", "--context", "<context-name>", "--read-only", "--deny-tool", "RDM_resolve_secret_reference"]
    }
  }
}
```

## Qué puede hacer el modelo

Todos los nombres de herramientas empiezan por `RDM_`. Cubren estas áreas:

<table><thead><tr><th width="200">ÁREA</th><th>EJEMPLOS</th></tr></thead><tbody><tr><td><strong>Espacios de trabajo</strong></td><td>Enumera los espacios de trabajo que la sesión puede usar (perfil local y cada contexto guardado de Devolutions Cloud o Devolutions Server) y cambia entre ellos durante el resto de la sesión.</td></tr><tr><td><strong>Bóvedas y entradas</strong></td><td>Enumerar bóvedas, buscar entradas, obtener una entrada, enumerar sus metadatos, archivos adjuntos, permisos y registros; crear, actualizar o eliminar bóvedas; actualizar, mover o eliminar entradas; exportar los registros de actividad a un archivo local.</td></tr><tr><td><strong>Usuarios y acceso</strong></td><td>Enumerar usuarios y grupos, crear o eliminar grupos, eliminar usuarios, enumerar el acceso a las bóvedas, conceder o revocar un rol de bóveda, enumerar roles de seguridad y conjuntos de permisos.</td></tr><tr><td><strong>Contraseñas</strong></td><td>Genere localmente contraseñas seguras, legibles, frases de contraseña o contraseñas por patrón.</td></tr><tr><td><strong>Secretos</strong></td><td>Resuelve una referencia <code>devo://</code> a su valor (<code>RDM_resolve_secret_reference</code>). La respuesta contiene el secreto.</td></tr><tr><td><strong>Proceso en segundo plano</strong></td><td>Comprueba, inicia, vuelve a cargar, reinicia o detiene el proceso en segundo plano de Devolutions CLI.</td></tr></tbody></table>

Las herramientas que crean, cambian o eliminan bóvedas, entradas, grupos, usuarios o acceso exigen una confirmación explícita en la solicitud. El modelo da esa confirmación, no usted: para mantener al modelo lejos de los cambios, use `--read-only`.

El servidor MCP no puede iniciar programas con secretos: para que un agente ejecute una herramienta con una credencial, use `devo secret run`. Consulte [Dar una credencial a un agente sin exponerla](/cli/es/guias/ai-agents/run-an-agent.md).

## Ver la lista de herramientas

Para ver qué herramientas expone el servidor, sin iniciarlo:

```bash
devo mcp catalog --json
```

En el resultado JSON, las herramientas que el servidor expondría tienen `"visible": true`. La salida de texto muestra solo las 25 primeras. `devo mcp catalog` acepta las mismas opciones de restricción que `devo mcp`, así que puede previsualizar una configuración antes de dársela a su cliente. Una excepción: la vista previa marca siempre `RDM_resolve_secret_reference` como oculta, incluso cuando `devo mcp` la expondría. Consulte [Limitar lo que puede hacer un agente](/cli/es/guias/ai-agents/limit-tools.md#preview-your-configuration).

## Bueno saberlo

* **El proceso en segundo plano se inicia por sí solo.** Cuando el servidor necesita su espacio de trabajo, `devo mcp` inicia el proceso en segundo plano de Devolutions CLI antes de responder al cliente, salvo que inicie el servidor con `--daemon require`, `--daemon never` o `--no-daemon-autostart`. Si las herramientas informan que el proceso no está disponible, consulte [El proceso en segundo plano no se inicia](/cli/es/ayuda/troubleshooting/daemon-wont-start.md).
* **El espacio de trabajo de la sesión puede cambiar.** A menos que inicie el servidor con `--read-only`, el modelo puede cambiar el espacio de trabajo para el resto de la sesión, entre el perfil local y los contextos que guardó. Las herramientas que lo cambian no son de solo lectura, así que `--read-only` las oculta.
* **El servidor se ejecuta como usted.** Cualquier programa que pueda iniciar `devo mcp` con su cuenta de usuario obtiene el mismo acceso a sus bóvedas.

## Siguiente

* [Limit what an agent can do](/cli/es/guias/ai-agents/limit-tools.md)
* [Give an agent a credential without exposing it](/cli/es/guias/ai-agents/run-an-agent.md)
* [What stays hidden, and what doesn't](/cli/es/guias/understand/security-model.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.devolutions.net/cli/es/guias/ai-agents/connect-mcp.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.