> ## 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. # Servidor MCP de NoimosAI > Usa NoimosAI desde Claude, ChatGPT, Cursor y otros clientes compatibles con MCP. ## Descripción general El servidor MCP de NoimosAI expone tu espacio de trabajo de NoimosAI mediante el [Model Context Protocol](https://modelcontextprotocol.io). Una vez conectado, los clientes compatibles con MCP pueden chatear con el agente de NoimosAI, listar espacios de trabajo e integraciones y publicar posts sociales directamente desde el cliente. Dos formas de conectarse: * **Remote MCP (recomendado)** — Alojado en `https://mcp.noimosai.com/mcp`. OAuth desde el navegador, sin instalación, actúa como tú. * **Local MCP (`@agos-labs/noimosai-mcp`)** — Ejecuta el servidor localmente con npm. Indicado para flujos con clave API / sin navegador. Endpoint: `https://mcp.noimosai.com/mcp` ### Requisitos * Una cuenta de NoimosAI (sesión iniciada) * Un cliente que admita Remote MCP / Custom Connectors ### Autorización El cliente se registra solo y luego se abre el navegador para iniciar sesión en NoimosAI y dar consentimiento al ámbito `mcp:tools`. Tras el consentimiento se emite un token de acceso y las llamadas a herramientas se ejecutan como tú. ### Conexión ```bash theme={null} claude mcp add --scope local --transport http noimos https://mcp.noimosai.com/mcp ``` Dentro de la sesión ejecuta `/mcp`, completa el consentimiento en el navegador y vuelve a Claude Code. Settings → Connectors → **Add custom connector** → URL `https://mcp.noimosai.com/mcp` → inicia sesión y acepta en el navegador. Agrega un Custom MCP connector con la URL `https://mcp.noimosai.com/mcp` y completa el consentimiento. ChatGPT no detecta herramientas genéricas `search` / `fetch`: llama a las herramientas de NoimosAI por nombre. ### Notas * Llama a `post` siempre primero con `dryRun: true` para revisar el contenido. Sin `dryRun`, los posts se publican en la cuenta social real. * Para desconectar, elimina el connector desde el cliente. ### Resolución de problemas * **El navegador no abre el consentimiento** — elimina el connector y vuelve a añadirlo. * **No aparece ninguna herramienta** — verifica que el ámbito `mcp:tools` esté concedido y que la cuenta tenga al menos un espacio de trabajo. * **Token expirado** — vuelve a autorizar desde el cliente. Publicado en npm como [`@agos-labs/noimosai-mcp`](https://www.npmjs.com/package/@agos-labs/noimosai-mcp). Se ejecuta como proceso hijo del cliente. ### Requisitos * Node.js `>= 18` * Un cliente compatible con MCP (Claude Desktop, Cursor, VS Code, …) * Una clave API de NoimosAI desde la configuración de tu equipo ### Configuración Sustituye `your-api-key` y `your-workspace-id` por los valores de tu equipo de NoimosAI. Añade a `claude_desktop_config.json`: ```json theme={null} { "mcpServers": { "noimosai": { "command": "npx", "args": ["-y", "@agos-labs/noimosai-mcp"], "env": { "NOIMOS_API_KEY": "your-api-key", "NOIMOS_WORKSPACE_ID": "your-workspace-id" } } } } ``` Añade a `.cursor/mcp.json`: ```json theme={null} { "mcpServers": { "noimosai": { "command": "npx", "args": ["-y", "@agos-labs/noimosai-mcp"], "env": { "NOIMOS_API_KEY": "your-api-key", "NOIMOS_WORKSPACE_ID": "your-workspace-id" } } } } ``` Añade a `.vscode/mcp.json`: ```json theme={null} { "servers": { "noimosai": { "command": "npx", "args": ["-y", "@agos-labs/noimosai-mcp"], "env": { "NOIMOS_API_KEY": "your-api-key", "NOIMOS_WORKSPACE_ID": "your-workspace-id" } } } } ``` Reinicia el cliente después de cambiar la configuración para que cargue el servidor MCP. ### Variables de entorno | Variable | Obligatoria | Descripción | | --------------------- | ----------- | ------------------------------------------------------------------------------------ | | `NOIMOS_API_KEY` | Sí | Clave API de NoimosAI (disponible en la pestaña API de la configuración del equipo). | | `NOIMOS_WORKSPACE_ID` | No | ID de espacio de trabajo por defecto cuando una llamada omite `workspaceId`. | ## Herramientas Ambos transportes exponen las mismas herramientas. ### `chat` Envía un mensaje al agente de NoimosAI. Devuelve NoimosPostJson estructurado con la respuesta del agente y los posts sociales extraídos. Sirve para análisis de marketing, creación de posts sociales, SEO y generación de contenido. | Parámetro | Tipo | Obligatorio | Descripción | | ------------- | -------- | ----------- | --------------------------------------------------------------------------------------- | | `prompt` | `string` | Sí | Mensaje o instrucción que se envía al agente. | | `workspaceId` | `string` | No | ID del espacio. Por defecto `NOIMOS_WORKSPACE_ID` (Local) o el de la cuenta autorizada. | | `sessionId` | `string` | No | ID de sesión para continuar una conversación. Si se omite, se crea una nueva sesión. | ### `list_workspaces` Lista los espacios de trabajo disponibles con su ID y nombre. Sin parámetros. ### `list_integrations` Lista las integraciones conectadas (cuentas sociales) del espacio. Devuelve IDs de cuenta (`providerAccountId`) que la herramienta `post` requiere en cada entrada. ### `post` Publica posts sociales. Acepta datos en formato NoimosPostJson devueltos por `chat`. Cada entrada debe incluir `providerAccountId` (obtenlo con `list_integrations`). Comienza siempre con `dryRun: true` para revisar el payload antes de publicar. | Parámetro | Tipo | Obligatorio | Descripción | | ------------- | --------- | ----------- | -------------------------------------------------------------------------------------- | | `posts` | `array` | Sí | Array de posts en formato NoimosPostJson. Cada entrada requiere `providerAccountId`. | | `schedule` | `string` | Sí | Momento de publicación. `"now"` para inmediato o `"YYYY-MM-DD HH:MM"` para programado. | | `workspaceId` | `string` | No | ID del espacio. Por defecto el espacio predeterminado. | | `dryRun` | `boolean` | No | Si es `true`, muestra lo que se enviaría sin publicar. Valor por defecto: `false`. | ## Relacionado * [¿Qué es NoimosAI?](/es/help-center/getting-started/what-is-noimosai) * [NoimosAI CLI](/es/developers/cli/overview) * [Paquete de npm](https://www.npmjs.com/package/@agos-labs/noimosai-mcp)