Connettere i client

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

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.

https://mcp.noimosai.com/mcp

Segui i passaggi del client.

In Claude Code aggiungi così l’endpoint.

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

Esegui /mcp nella sessione, autorizza nel browser e torna.

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.

In ChatGPT Desktop aggiungi un server MCP.

Apri Settings → MCP servers, poi Add server.
Imposta nome NoimosAI, trasporto Streamable HTTP e URL https://mcp.noimosai.com/mcp.
Salva e scegli Restart.
Scegli Authenticate e autorizza nel browser.

Digita /mcp per vedere i server. La guida OpenAI attuale indica che ChatGPT Web usa strumenti Remote dei plugin, non configurazioni locali. Questi passaggi diretti riguardano Desktop.

In Codex CLI questi comandi aggiungono l’endpoint e avviano OAuth.

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.

In Cursor aggiungi al .cursor/mcp.json del progetto.

{
  "mcpServers": {
    "noimosai": {
      "url": "https://mcp.noimosai.com/mcp"
    }
  }
}

Attiva NoimosAI nelle impostazioni MCP e completa l’accesso browser.

In VS Code aggiungi al .vscode/mcp.json dello spazio.

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

Non condividere né committare configurazioni con chiavi. Usa una chiave ordinaria; le Developer Platform nmp_ non sono valide qui.

Claude Code
Claude Desktop
Codex
Cursor
VS Code

In Claude Code aggiungi il server così.

claude mcp add noimosai \
  --env NOIMOS_API_KEY=your-api-key \
  --env MCP_TOOL_TIMEOUT=900000 \
  -- npx -y @noimosai/mcp

In Claude Desktop completa claude_desktop_config.json.

{
  "mcpServers": {
    "noimosai": {
      "command": "npx",
      "args": ["-y", "@noimosai/mcp"],
      "env": {
        "NOIMOS_API_KEY": "your-api-key"
      }
    }
  }
}

In Codex CLI aggiungi il server così.

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.

In Cursor completa .cursor/mcp.json.

{
  "mcpServers": {
    "noimosai": {
      "command": "npx",
      "args": ["-y", "@noimosai/mcp"],
      "env": {
        "NOIMOS_API_KEY": "your-api-key"
      }
    }
  }
}

In VS Code completa .vscode/mcp.json.

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

«Elenca gli spazi NoimosAI disponibili».
«Controlla brand e account dello spazio scelto».
«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.

Primi passi

API

CLI

Server MCP

Connettere i client

Panoramica

Scegliere la connessione

Connettere Remote

Connettere Local

Provare gli strumenti

Risolvere problemi

Pagine correlate

​Panoramica

​Scegliere la connessione

​Connettere Remote

​Connettere Local

​Provare gli strumenti

​Risolvere problemi

​Pagine correlate

Panoramica

Scegliere la connessione

Connettere Remote

Connettere Local

Provare gli strumenti

Risolvere problemi

Pagine correlate