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

# Connettere i client

> Collega Remote o Local MCP a un client compatibile.

## Panoramica

Collega Claude, ChatGPT Desktop, Codex, Cursor o VS Code. Preferisci Remote senza installazione o chiavi; Local per file locali o ambienti senza interfaccia.

## Scegliere la connessione

Scegli secondo ambiente e necessità di file locali.

| Metodo | Uso | Autenticazione | Installazione |
| - | - | - | - |
| Remote MCP | Client abituali | OAuth browser | Nessuna |
| Local MCP | Senza interfaccia o file locali | Chiave NoimosAI | Node.js e pacchetto npm |

> [!NOTE]
>
> Remote non supporta `upload_media`, `upload_website_source` e `download_creation` che usano file locali. Per questi usa Local.

## Connettere Remote

Registra l’endpoint NoimosAI e autorizza nel browser.

Prepara due elementi:

* Account NoimosAI
* Client MCP con Streamable HTTP e OAuth

Usa questo URL.

```text theme={null}
https://mcp.noimosai.com/mcp
```

Segui i passaggi del client.

> [tab] Claude Code
>
> In Claude Code aggiungi così l’endpoint.
>
> ```bash theme={null}
> claude mcp add --scope local --transport http noimosai https://mcp.noimosai.com/mcp
> ```
>
> Esegui `/mcp` nella sessione, autorizza nel browser e torna.

> [tab] Claude.ai / Desktop
>
> In Claude.ai o Claude Desktop registra un connettore personalizzato.
>
> Apri **Settings → Connectors → Add custom connector**, inserisci `https://mcp.noimosai.com/mcp`, salva e accedi e autorizza nel browser.

> [tab] ChatGPT Desktop
>
> In ChatGPT Desktop aggiungi un server MCP.
>
> 1. Apri **Settings → MCP servers**, poi **Add server**.
> 2. Imposta nome `NoimosAI`, trasporto **Streamable HTTP** e URL `https://mcp.noimosai.com/mcp`.
> 3. Salva e scegli **Restart**.
> 4. Scegli **Authenticate** e autorizza nel browser.
>
> Digita `/mcp` per vedere i server. La [guida OpenAI attuale](https://learn.chatgpt.com/docs/extend/mcp) indica che ChatGPT Web usa strumenti Remote dei plugin, non configurazioni locali. Questi passaggi diretti riguardano Desktop.

> [tab] Codex
>
> In Codex CLI questi comandi aggiungono l’endpoint e avviano OAuth.
>
> ```bash theme={null}
> codex mcp add noimosai --url https://mcp.noimosai.com/mcp
> codex mcp login noimosai
> ```
>
> Controlla con `codex mcp list`. ChatGPT Desktop, Codex CLI ed estensione IDE condividono le impostazioni MCP dello stesso host Codex.

> [tab] Cursor
>
> In Cursor aggiungi al `.cursor/mcp.json` del progetto.
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "noimosai": {
>       "url": "https://mcp.noimosai.com/mcp"
>     }
>   }
> }
> ```
>
> Attiva NoimosAI nelle impostazioni MCP e completa l’accesso browser.

> [tab] VS Code
>
> In VS Code aggiungi al `.vscode/mcp.json` dello spazio.
>
> ```json theme={null}
> {
>   "servers": {
>     "noimosai": {
>       "type": "http",
>       "url": "https://mcp.noimosai.com/mcp"
>     }
>   }
> }
> ```
>
> Avviare il server apre OAuth nel browser.

Controlla account e permesso `mcp:tools` al consenso. Riconnetti e verifica gli strumenti.

## Connettere Local

Local avvia [`@noimosai/mcp`](https://www.npmjs.com/package/@noimosai/mcp), pubblicato su npm, come processo figlio del client.

Prepara tre elementi:

* Node.js 20 o successivo
* Client MCP con STDIO
* Chiave della scheda API nelle impostazioni del team

Sostituisci `your-api-key` con la chiave. Aggiungi `NOIMOS_WORKSPACE_ID` solo per fissare lo spazio predefinito.

> [!WARNING]
>
> Non condividere né committare configurazioni con chiavi. Usa una chiave ordinaria; le Developer Platform `nmp_` non sono valide qui.

> [tab] Claude Code
>
> In Claude Code aggiungi il server così.
>
> ```bash theme={null}
> claude mcp add noimosai \
>   --env NOIMOS_API_KEY=your-api-key \
>   --env MCP_TOOL_TIMEOUT=900000 \
>   -- npx -y @noimosai/mcp
> ```

> [tab] Claude Desktop
>
> In Claude Desktop completa `claude_desktop_config.json`.
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "noimosai": {
>       "command": "npx",
>       "args": ["-y", "@noimosai/mcp"],
>       "env": {
>         "NOIMOS_API_KEY": "your-api-key"
>       }
>     }
>   }
> }
> ```

> [tab] Codex
>
> In Codex CLI aggiungi il server così.
>
> ```bash theme={null}
> codex mcp add noimosai \
>   --env NOIMOS_API_KEY=your-api-key \
>   --env NOIMOS_MCP_ALLOWED_UPLOAD_ROOTS="$PWD" \
>   -- npx -y @noimosai/mcp
> ```
>
> Consente trasferimenti solo nella cartella d’esecuzione.

> [tab] Cursor
>
> In Cursor completa `.cursor/mcp.json`.
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "noimosai": {
>       "command": "npx",
>       "args": ["-y", "@noimosai/mcp"],
>       "env": {
>         "NOIMOS_API_KEY": "your-api-key"
>       }
>     }
>   }
> }
> ```

> [tab] VS Code
>
> In VS Code completa `.vscode/mcp.json`.
>
> ```json theme={null}
> {
>   "servers": {
>     "noimosai": {
>       "type": "stdio",
>       "command": "npx",
>       "args": ["-y", "@noimosai/mcp"],
>       "env": {
>         "NOIMOS_API_KEY": "your-api-key"
>       }
>     }
>   }
> }
> ```

Variabili disponibili:

| Variabile | Obbligatoria | Descrizione |
| - | - | - |
| `NOIMOS_API_KEY` | Sì | Chiave della scheda API del team. |
| `NOIMOS_WORKSPACE_ID` | No | Spazio predefinito se manca `workspaceId`. |
| `NOIMOS_MCP_ALLOWED_UPLOAD_ROOTS` | No | Cartelle consentite; separa più percorsi con il separatore del sistema. |

Consenti solo cartelle necessarie. Per quella corrente imposta il percorso assoluto in `NOIMOS_MCP_ALLOWED_UPLOAD_ROOTS` nella configurazione.

Riavvia e verifica gli strumenti. `chat` e `create_workspace_and_onboard` possono durare minuti; se possibile prevedi circa 15 minuti di timeout.

## Provare gli strumenti

Inizia con letture per controllare spazio e dati senza modificarli.

Chiedi in quest’ordine:

1. «Elenca gli spazi NoimosAI disponibili».
2. «Controlla brand e account dello spazio scelto».
3. «Crea una bozza LinkedIn con quei dati. Mostra solo testo, senza pubblicare».

Le prime richieste usano letture come `list_workspaces` e `get_workspace_context`. La terza non pubblica: controlla il testo prima di proseguire.

## Risolvere problemi

Verifica secondo la connessione:

* **Consenso Remote assente** — Rimuovi e aggiungi la connessione.
* **Strumenti Remote assenti** — Controlla `mcp:tools` e presenza di uno spazio.
* **Token Remote scaduto** — Autorizza di nuovo.
* **Local non parte** — Controlla Node.js 20+, `npx`, pacchetto e chiave.
* **Spazio Local non selezionabile** — Controlla `NOIMOS_WORKSPACE_ID` o `workspaceId` nella chiamata.
* **File Local illeggibile** — Controlla la cartella consentita da `NOIMOS_MCP_ALLOWED_UPLOAD_ROOTS`.

## Pagine correlate

Queste pagine descrivono strumenti e altri accessi.

* [Usare gli strumenti](https://docs.noimosai.com/it/developers/mcp/tools.md)
* [Comprendere le basi](https://docs.noimosai.com/it/developers/cli/overview.md)
* [Guida standard alla connessione MCP](https://modelcontextprotocol.io/docs/develop/connect-local-servers)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.