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

# Server MCP NoimosAI

> Usa NoimosAI da Claude, ChatGPT, Cursor e altri client compatibili con MCP.

## Panoramica

Il server MCP NoimosAI espone il tuo workspace NoimosAI tramite il [Model Context Protocol](https://modelcontextprotocol.io). 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.

<Tabs>
  <Tab title="Remote (consigliato)">
    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

    <Tabs>
      <Tab title="Claude Code">
        ```bash theme={null}
        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.
      </Tab>

      <Tab title="Claude.ai / Desktop">
        Settings → Connectors → **Add custom connector** → URL `https://mcp.noimosai.com/mcp` → effettua l’accesso e dai il consenso nel browser.
      </Tab>

      <Tab title="ChatGPT Web">
        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.
      </Tab>
    </Tabs>

    ### 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.
  </Tab>

  <Tab title="Local (npm)">
    Pubblicato su npm come [`@agos-labs/noimosai-mcp`](https://www.npmjs.com/package/@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.

    <Tabs>
      <Tab title="Claude Desktop">
        Aggiungi in `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"
              }
            }
          }
        }
        ```
      </Tab>

      <Tab title="Cursor">
        Aggiungi in `.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"
              }
            }
          }
        }
        ```
      </Tab>

      <Tab title="VS Code">
        Aggiungi in `.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"
              }
            }
          }
        }
        ```
      </Tab>
    </Tabs>

    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`.          |
  </Tab>
</Tabs>

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

## Correlati

* [Che cos'è NoimosAI?](/it/help-center/getting-started/what-is-noimosai)
* [NoimosAI CLI](/it/developers/cli/overview)
* [Pacchetto npm](https://www.npmjs.com/package/@agos-labs/noimosai-mcp)