Conectar clientes

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

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.

https://mcp.noimosai.com/mcp

Sigue los pasos de tu cliente.

En Claude Code, añade el endpoint así.

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.

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.

En ChatGPT Desktop, registra un servidor MCP.

Abre Settings → MCP servers y Add server.
Configura nombre NoimosAI, transporte Streamable HTTP y URL https://mcp.noimosai.com/mcp.
Guarda y elige Restart.
Elige Authenticate y autoriza en el navegador.

Escribe /mcp para ver servidores. La guía actual de OpenAI indica que ChatGPT Web usa herramientas Remote de plugins instalados, no configuración local. Estos pasos directos son para Desktop.

En Codex CLI, estos comandos añaden el endpoint e inician OAuth.

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.

En Cursor, añade esta configuración al .cursor/mcp.json del proyecto.

{
  "mcpServers": {
    "noimosai": {
      "url": "https://mcp.noimosai.com/mcp"
    }
  }
}

Activa NoimosAI en ajustes MCP y completa la autenticación del navegador.

En VS Code, añade la configuración al .vscode/mcp.json del espacio.

{
  "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, 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.

No compartas ni guardes en Git configuraciones con claves. Usa una clave habitual; las Developer Platform nmp_ no sirven.

Claude Code
Claude Desktop
Codex
Cursor
VS Code

En Claude Code, añade el servidor local así.

claude mcp add noimosai \
  --env NOIMOS_API_KEY=your-api-key \
  --env MCP_TOOL_TIMEOUT=900000 \
  -- npx -y @noimosai/mcp

En Claude Desktop, completa claude_desktop_config.json.

{
  "mcpServers": {
    "noimosai": {
      "command": "npx",
      "args": ["-y", "@noimosai/mcp"],
      "env": {
        "NOIMOS_API_KEY": "your-api-key"
      }
    }
  }
}

En Codex CLI, añade el servidor local así.

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.

En Cursor, completa .cursor/mcp.json.

{
  "mcpServers": {
    "noimosai": {
      "command": "npx",
      "args": ["-y", "@noimosai/mcp"],
      "env": {
        "NOIMOS_API_KEY": "your-api-key"
      }
    }
  }
}

En VS Code, completa .vscode/mcp.json.

{
  "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:

«Lista mis espacios NoimosAI disponibles».
«Revisa marca y cuentas conectadas del espacio objetivo».
«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.

Primeros pasos

API

CLI

Servidor MCP

Conectar clientes

Descripción general

Elegir conexión

Conectar Remote

Conectar Local

Probar herramientas

Resolver problemas

Páginas relacionadas

​Descripción general

​Elegir conexión

​Conectar Remote

​Conectar Local

​Probar herramientas

​Resolver problemas

​Páginas relacionadas

Descripción general

Elegir conexión

Conectar Remote

Conectar Local

Probar herramientas

Resolver problemas

Páginas relacionadas