Server MCP NoimosAI

Panoramica

Il server MCP NoimosAI espone il tuo workspace NoimosAI tramite il Model Context Protocol. Una volta collegato, un client compatibile con MCP può chattare con l’agente NoimosAI, elencare workspace e integrazioni e pubblicare post social direttamente dal client. Due modalità di connessione:

Remote MCP (consigliato) — Ospitato su https://mcp.noimosai.com/mcp. OAuth dal browser, nessuna installazione, agisce come te.
Local MCP (@agos-labs/noimosai-mcp) — Esegui il server in locale via npm. Adatto a flussi headless / con chiave API.

Remote (consigliato)
Local (npm)

Endpoint: https://mcp.noimosai.com/mcp

Requisiti

Un account NoimosAI (con accesso effettuato)
Un client che supporta Remote MCP / Custom Connectors

Autorizzazione

Il client si registra da solo, poi si apre il browser per l’accesso a NoimosAI e il consenso allo scope mcp:tools. Dopo il consenso viene rilasciato un token di accesso e le chiamate agli strumenti vengono eseguite come te.

Connessione

Claude Code
Claude.ai / Desktop
ChatGPT Web

claude mcp add --scope local --transport http noimos https://mcp.noimosai.com/mcp

Nella sessione esegui /mcp, completa il consenso nel browser e torna a Claude Code.

Settings → Connectors → Add custom connector → URL https://mcp.noimosai.com/mcp → effettua l’accesso e dai il consenso nel browser.

Aggiungi un Custom MCP connector con URL https://mcp.noimosai.com/mcp e completa il consenso. ChatGPT non rileva automaticamente strumenti generici search / fetch: richiama gli strumenti NoimosAI per nome.

Note

Chiama post sempre prima con dryRun: true per controllare il payload. Senza dryRun i post vengono pubblicati sull’account social reale.
Per disconnetterti rimuovi il connector dal client.

Risoluzione dei problemi

Il browser non apre il consenso — rimuovi il connector e aggiungilo di nuovo.
Nessuno strumento elencato — verifica che lo scope mcp:tools sia stato concesso e che l’account abbia almeno un workspace.
Token scaduto — riautorizza dal client.

Pubblicato su npm come @agos-labs/noimosai-mcp. Viene eseguito come processo figlio del client.

Requisiti

Node.js >= 18
Un client compatibile con MCP (Claude Desktop, Cursor, VS Code, …)
Una chiave API NoimosAI dalle impostazioni del team

Configurazione

Sostituisci your-api-key e your-workspace-id con i valori del tuo team NoimosAI.

Claude Desktop
Cursor
VS Code

Aggiungi in 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"
      }
    }
  }
}

Aggiungi in .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"
      }
    }
  }
}

Aggiungi in .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"
      }
    }
  }
}

Dopo aver aggiornato la configurazione, riavvia il client per caricare il server MCP.

Variabili d’ambiente

Variabile	Obbligatoria	Descrizione
`NOIMOS_API_KEY`	Sì	Chiave API NoimosAI (disponibile nella scheda API delle impostazioni del team).
`NOIMOS_WORKSPACE_ID`	No	ID del workspace predefinito quando una chiamata omette `workspaceId`.

Strumenti

Entrambi i trasporti espongono gli stessi strumenti.

`chat`

Invia un messaggio all’agente NoimosAI. Restituisce un NoimosPostJson strutturato con la risposta dell’agente e gli eventuali post social estratti. Adatto ad analisi marketing, creazione di post social, SEO e generazione di contenuti.

Parametro	Tipo	Obbligatorio	Descrizione
`prompt`	`string`	Sì	Messaggio o istruzione da inviare all’agente.
`workspaceId`	`string`	No	ID del workspace. Default: `NOIMOS_WORKSPACE_ID` (Local) o quello dell’account autorizzato.
`sessionId`	`string`	No	ID di sessione per continuare una conversazione. Se omesso viene creata una nuova sessione.

`list_workspaces`

Elenca i workspace disponibili con ID e nome. Nessun parametro.

`list_integrations`

Elenca le integrazioni collegate (account social) del workspace. Restituisce ID account (providerAccountId) richiesti dallo strumento post in ogni voce.

`post`

Pubblica post social. Accetta dati in formato NoimosPostJson restituiti da chat. Ogni voce deve includere providerAccountId (ottenuto da list_integrations). Inizia sempre con dryRun: true per controllare il payload prima della pubblicazione.

Parametro	Tipo	Obbligatorio	Descrizione
`posts`	`array`	Sì	Array di post in formato NoimosPostJson. Ogni voce richiede `providerAccountId`.
`schedule`	`string`	Sì	Orario di pubblicazione. `"now"` per immediato o `"YYYY-MM-DD HH:MM"` per programmato.
`workspaceId`	`string`	No	ID del workspace. Default: workspace predefinito.
`dryRun`	`boolean`	No	Se `true`, mostra ciò che verrebbe inviato senza pubblicare. Valore predefinito `false`.

Sviluppatori

Server MCP NoimosAI

Panoramica

Requisiti

Autorizzazione

Connessione

Note

Risoluzione dei problemi

Requisiti

Configurazione

Variabili d’ambiente

Strumenti

`chat`

`list_workspaces`

`list_integrations`

`post`

Correlati

Sviluppatori

Documentation Index

​Panoramica

​Requisiti

​Autorizzazione

​Connessione

​Note

​Risoluzione dei problemi

​Requisiti

​Configurazione

​Variabili d’ambiente

​Strumenti

​chat

​list_workspaces

​list_integrations

​post

​Correlati

Panoramica

Requisiti

Autorizzazione

Connessione

Note

Risoluzione dei problemi

Requisiti

Configurazione

Variabili d’ambiente

Strumenti

`chat`

`list_workspaces`

`list_integrations`

`post`

Correlati