> ## Documentation Index
> Fetch the complete documentation index at: https://docs.noimosai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Conectar clientes

> Conecta Remote o Local MCP a un cliente compatible.

## Descripción general

Conecta Claude, ChatGPT Desktop, Codex, Cursor o VS Code. Normalmente usa Remote, sin instalación ni gestión de claves; Local para archivos locales o entornos sin interfaz.

## Elegir conexión

Elige según entorno y necesidad de archivos locales.

| Método | Uso | Autenticación | Instalación |
| - | - | - | - |
| Remote MCP | Clientes habituales | OAuth en navegador | Ninguna |
| Local MCP | Sin interfaz o archivos locales | Clave NoimosAI | Node.js y paquete npm |

> [!NOTE]
>
> Remote no admite `upload_media`, `upload_website_source` ni `download_creation`, que usan archivos locales. Usa Local para ellos.

## Conectar Remote

Registra el endpoint NoimosAI y autoriza el acceso en el navegador.

Prepara dos cosas:

* Cuenta NoimosAI
* Cliente MCP con Streamable HTTP y OAuth

Usa esta URL.

```text theme={null}
https://mcp.noimosai.com/mcp
```

Sigue los pasos de tu cliente.

> [tab] Claude Code
>
> En Claude Code, añade el endpoint así.
>
> ```bash theme={null}
> claude mcp add --scope local --transport http noimosai https://mcp.noimosai.com/mcp
> ```
>
> Ejecuta `/mcp` en una sesión, autoriza en el navegador y vuelve.

> [tab] Claude.ai / Desktop
>
> En Claude.ai o Claude Desktop, registra un conector personalizado.
>
> Abre **Settings → Connectors → Add custom connector**, introduce `https://mcp.noimosai.com/mcp`, guarda e inicia sesión y autoriza en el navegador.

> [tab] ChatGPT Desktop
>
> En ChatGPT Desktop, registra un servidor MCP.
>
> 1. Abre **Settings → MCP servers** y **Add server**.
> 2. Configura nombre `NoimosAI`, transporte **Streamable HTTP** y URL `https://mcp.noimosai.com/mcp`.
> 3. Guarda y elige **Restart**.
> 4. Elige **Authenticate** y autoriza en el navegador.
>
> Escribe `/mcp` para ver servidores. La [guía actual de OpenAI](https://learn.chatgpt.com/docs/extend/mcp) indica que ChatGPT Web usa herramientas Remote de plugins instalados, no configuración local. Estos pasos directos son para Desktop.

> [tab] Codex
>
> En Codex CLI, estos comandos añaden el endpoint e inician OAuth.
>
> ```bash theme={null}
> codex mcp add noimosai --url https://mcp.noimosai.com/mcp
> codex mcp login noimosai
> ```
>
> Consulta `codex mcp list`. ChatGPT Desktop, Codex CLI y la extensión IDE comparten configuración MCP en el mismo host Codex.

> [tab] Cursor
>
> En Cursor, añade esta configuración al `.cursor/mcp.json` del proyecto.
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "noimosai": {
>       "url": "https://mcp.noimosai.com/mcp"
>     }
>   }
> }
> ```
>
> Activa NoimosAI en ajustes MCP y completa la autenticación del navegador.

> [tab] VS Code
>
> En VS Code, añade la configuración al `.vscode/mcp.json` del espacio.
>
> ```json theme={null}
> {
>   "servers": {
>     "noimosai": {
>       "type": "http",
>       "url": "https://mcp.noimosai.com/mcp"
>     }
>   }
> }
> ```
>
> Al iniciar el servidor, VS Code abre OAuth en el navegador.

Revisa cuenta y permiso `mcp:tools` en el consentimiento. Reconecta y comprueba las herramientas.

## Conectar Local

Local ejecuta [`@noimosai/mcp`](https://www.npmjs.com/package/@noimosai/mcp), publicado en npm, como proceso hijo del cliente.

Prepara tres cosas:

* Node.js 20 o posterior
* Cliente MCP con STDIO
* Clave de la pestaña API de los ajustes de equipo NoimosAI

Sustituye `your-api-key` por tu clave. Añade `NOIMOS_WORKSPACE_ID` solo para fijar el espacio predeterminado.

> [!WARNING]
>
> No compartas ni guardes en Git configuraciones con claves. Usa una clave habitual; las Developer Platform `nmp_` no sirven.

> [tab] Claude Code
>
> En Claude Code, añade el servidor local así.
>
> ```bash theme={null}
> claude mcp add noimosai \
>   --env NOIMOS_API_KEY=your-api-key \
>   --env MCP_TOOL_TIMEOUT=900000 \
>   -- npx -y @noimosai/mcp
> ```

> [tab] Claude Desktop
>
> En Claude Desktop, completa `claude_desktop_config.json`.
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "noimosai": {
>       "command": "npx",
>       "args": ["-y", "@noimosai/mcp"],
>       "env": {
>         "NOIMOS_API_KEY": "your-api-key"
>       }
>     }
>   }
> }
> ```

> [tab] Codex
>
> En Codex CLI, añade el servidor local así.
>
> ```bash theme={null}
> codex mcp add noimosai \
>   --env NOIMOS_API_KEY=your-api-key \
>   --env NOIMOS_MCP_ALLOWED_UPLOAD_ROOTS="$PWD" \
>   -- npx -y @noimosai/mcp
> ```
>
> Esto permite subidas y descargas solo en la carpeta donde se ejecuta.

> [tab] Cursor
>
> En Cursor, completa `.cursor/mcp.json`.
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "noimosai": {
>       "command": "npx",
>       "args": ["-y", "@noimosai/mcp"],
>       "env": {
>         "NOIMOS_API_KEY": "your-api-key"
>       }
>     }
>   }
> }
> ```

> [tab] VS Code
>
> En VS Code, completa `.vscode/mcp.json`.
>
> ```json theme={null}
> {
>   "servers": {
>     "noimosai": {
>       "type": "stdio",
>       "command": "npx",
>       "args": ["-y", "@noimosai/mcp"],
>       "env": {
>         "NOIMOS_API_KEY": "your-api-key"
>       }
>     }
>   }
> }
> ```

Variables disponibles:

| Variable | Obligatoria | Descripción |
| - | - | - |
| `NOIMOS_API_KEY` | Sí | Clave de la pestaña API de ajustes de equipo. |
| `NOIMOS_WORKSPACE_ID` | No | Espacio predeterminado si se omite `workspaceId`. |
| `NOIMOS_MCP_ALLOWED_UPLOAD_ROOTS` | No | Carpetas permitidas; separa varias rutas con el separador del sistema. |

Permite solo carpetas necesarias. Para la actual, añade su ruta absoluta como `NOIMOS_MCP_ALLOWED_UPLOAD_ROOTS` en la configuración.

Reinicia y comprueba herramientas. `chat` y `create_workspace_and_onboard` pueden tardar minutos; configura unos 15 minutos si es posible.

## Probar herramientas

Empieza con lecturas para revisar espacio e información sin modificar datos.

Pide en este orden:

1. «Lista mis espacios NoimosAI disponibles».
2. «Revisa marca y cuentas conectadas del espacio objetivo».
3. «Crea un borrador LinkedIn con esa información. Muestra solo texto y no publiques».

Las primeras usan lecturas como `list_workspaces` y `get_workspace_context`. La tercera tampoco publica: revisa el texto antes de decidir la siguiente acción.

## Resolver problemas

Revisa según la conexión:

* **No abre consentimiento Remote** — Elimina y añade la conexión.
* **Faltan herramientas Remote** — Revisa `mcp:tools` y que exista un espacio.
* **Token Remote vencido** — Autoriza de nuevo.
* **Local no inicia** — Revisa Node.js 20+, `npx`, paquete y clave.
* **No selecciona espacio Local** — Revisa `NOIMOS_WORKSPACE_ID` o `workspaceId` del llamado.
* **No lee archivos Local** — Comprueba carpeta permitida por `NOIMOS_MCP_ALLOWED_UPLOAD_ROOTS`.

## Páginas relacionadas

Estas páginas explican herramientas y otros accesos.

* [Usar herramientas](https://docs.noimosai.com/es/developers/mcp/tools.md)
* [Entender los conceptos básicos](https://docs.noimosai.com/es/developers/cli/overview.md)
* [Guía estándar de conexión MCP](https://modelcontextprotocol.io/docs/develop/connect-local-servers)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.