> For the complete documentation index, see [llms.txt](https://docs.agentsby.yudexlabs.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.agentsby.yudexlabs.com/guias/conectar-agents-desde-codex-claude-code-u-otro-asistente.md).

# Conectar Agents desde Codex, Claude Code u otro asistente

## ¿Qué es MCP?

MCP es una forma segura de conectar un asistente de IA con Agents.

Piensa en MCP como un puente: tu asistente puede ayudarte a consultar y configurar tus agentes sin que tengas que copiar información de un lado a otro.

La conexión no entrega acceso a la base de datos ni a la información interna de Agents. Solo permite las acciones que autorices.

## Antes de empezar

Necesitas:

* Una cuenta de Agents con permisos de propietario o administrador.
* Codex, Claude Code u otro asistente que permita conectar servidores MCP remotos.
* Acceso a un navegador para iniciar sesión y confirmar la conexión.

Usa siempre esta dirección:

`https://api-agents.yudexlabs.com/mcp`

## Conexión recomendada: iniciar sesión en el navegador

La mayoría de los clientes pueden abrir el navegador automáticamente para confirmar tu identidad.

1. Abre la sección donde tu asistente permite agregar conexiones MCP.
2. Crea una conexión nueva de tipo **HTTP**, **HTTP secuenciable** o **MCP remoto**. El nombre puede variar.
3. Escribe `Agents by Yudex Labs` como nombre.
4. Pega la dirección MCP: `https://api-agents.yudexlabs.com/mcp`.
5. Deja vacíos el token y los encabezados si el cliente ofrece autenticación mediante navegador.
6. Guarda la conexión.
7. Cuando se abra el navegador, inicia sesión en Agents y revisa los permisos solicitados.
8. Confirma la conexión y vuelve a tu asistente.

Guardar la conexión solo registra el servidor. La autorización normalmente comienza cuando el asistente intenta usarlo por primera vez.

## Conectar desde Codex

En Codex:

1. Abre **Configuración → Complementos → MCP**.
2. Selecciona **Agregar** y luego **Conectar con un MCP personalizado**.
3. Completa estos datos:

| Campo  | Valor                                  |
| ------ | -------------------------------------- |
| Nombre | `Agents by Yudex Labs`                 |
| Tipo   | `HTTP secuenciable`                    |
| URL    | `https://api-agents.yudexlabs.com/mcp` |
| Token  | Déjalo vacío para usar el navegador    |

4. Guarda la conexión.
5. Completa el inicio de sesión y la autorización en el navegador.
6. Regresa al chat y pide, por ejemplo: “Muéstrame los agentes de mi cuenta”.

## Conectar desde Claude Code

Abre una terminal y ejecuta:

```bash
claude mcp add --transport http yudex-agents https://api-agents.yudexlabs.com/mcp
```

Después, Claude Code abrirá el navegador para que inicies sesión y confirmes los permisos.

Cuando termine, puedes pedirle que compruebe la conexión o que muestre tus agentes.

## Conectar desde otro asistente

Busca una opción parecida a **MCP**, **Conexiones**, **Herramientas** o **Servidores remotos** y agrega:

* **Nombre:** Agents by Yudex Labs
* **Tipo:** HTTP, HTTP secuenciable o MCP remoto
* **URL:** `https://api-agents.yudexlabs.com/mcp`
* **Autenticación:** OAuth o inicio de sesión en el navegador

Los nombres de los campos cambian entre aplicaciones, pero la dirección es la misma.

## Si el asistente no puede abrir el navegador

Como alternativa, puedes crear un token técnico desde **Configuración → Acceso MCP** en Agents.

El token se muestra una sola vez. Guárdalo en el gestor de secretos o en una variable de entorno del cliente, por ejemplo:

`YUDEX_MCP_TOKEN`

En el campo de token, escribe el nombre de la variable si tu cliente lo permite. Nunca pegues el valor del token en:

* Un chat o prompt.
* Una URL.
* Un repositorio.
* Un archivo compartido.
* Un registro de actividad.

## Qué puedes pedir después de conectar

Puedes pedirle a tu asistente que:

* Muestre los agentes disponibles.
* Consulte la configuración de un agente.
* Inicie un borrador de cambios.
* Te indique qué información falta.
* Muestre una vista previa antes de aplicar cambios.
* Pruebe un agente en un entorno seguro.

Agents siempre debe mostrarte una vista previa antes de aplicar cambios importantes. Revisa esa vista previa y confirma solo cuando estés de acuerdo.

## Si algo no funciona

* Revisa que la dirección sea exactamente `https://api-agents.yudexlabs.com/mcp`.
* Recarga o reinicia el asistente después de guardar la conexión.
* Completa la autorización en el navegador con la cuenta correcta.
* No vuelvas a pegar un token en el chat.
* Si la conexión se cierra o el navegador no aparece, elimina y vuelve a agregar el servidor. Si continúa, contacta a soporte indicando el nombre del asistente y el mensaje visible del error.


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.agentsby.yudexlabs.com/guias/conectar-agents-desde-codex-claude-code-u-otro-asistente.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.