Servidor MCP de NoimosAI

Descripción general

El servidor MCP de NoimosAI expone tu espacio de trabajo de NoimosAI mediante el Model Context Protocol. 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.

Remote (recomendado)
Local (npm)

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

Claude Code
Claude.ai / Desktop
ChatGPT Web

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. 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.

Claude Desktop
Cursor
VS Code

Añade a claude_desktop_config.json:

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

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

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

Desarrolladores

Servidor MCP de NoimosAI

Descripción general

Requisitos

Autorización

Conexión

Notas

Resolución de problemas

Requisitos

Configuración

Variables de entorno

Herramientas

`chat`

`list_workspaces`

`list_integrations`

`post`

Relacionado

Desarrolladores

Documentation Index

​Descripción general

​Requisitos

​Autorización

​Conexión

​Notas

​Resolución de problemas

​Requisitos

​Configuración

​Variables de entorno

​Herramientas

​chat

​list_workspaces

​list_integrations

​post

​Relacionado

Descripción general

Requisitos

Autorización

Conexión

Notas

Resolución de problemas

Requisitos

Configuración

Variables de entorno

Herramientas

`chat`

`list_workspaces`

`list_integrations`

`post`

Relacionado