Connetti Cursor e altri client

Ogni server GPT Workspace comunica tramite HTTP streaming con OAuth 2.0, quindi qualsiasi client che supporti server MCP remoti può utilizzarlo. L’unica cosa da configurare è l’URL; il client scopre automaticamente gli endpoint OAuth e apre la pagina di accesso di Google al primo utilizzo.

Apri Cursor Settings ➤ MCP e fai clic su Add new global MCP server, oppure modifica ~/.cursor/mcp.json (globale) o .cursor/mcp.json in un progetto:

{
  "mcpServers": {
    "google-sheets": {
      "url": "https://api.gpt.space/servers/google-sheets/mcp"
    },
    "gmail": {
      "url": "https://api.gpt.space/servers/gmail/mcp"
    }
  }
}

Salva, quindi fai clic su Connect o sul link di accesso accanto al server nelle impostazioni MCP. Dopo la schermata di consenso di Google, gli strumenti appariranno con un punto verde.

Esegui MCP: Add Server dal pannello dei comandi, scegli HTTP, incolla l’URL e un nome. Oppure aggiungi a .vscode/mcp.json:

{
  "servers": {
    "google-docs": {
      "type": "http",
      "url": "https://api.gpt.space/servers/google-docs/mcp"
    }
  }
}

Fai clic su Start accanto al server e accedi con Google quando richiesto.

Usa la stessa struttura: una voce server con un campo url (alcuni client chiamano il campo serverUrl o richiedono "type": "streamable-http"). Consulta la documentazione del tuo client per i nomi esatti delle chiavi.

Alcuni client eseguono solo comandi locali. Collega il server remoto con mcp-remote, che gestisce il flusso OAuth nel browser e conserva il token:

{
  "mcpServers": {
    "google-drive": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.gpt.space/servers/google-drive/mcp"]
    }
  }
}

Usa qualsiasi SDK MCP con il trasporto HTTP streaming e un provider di client OAuth. Il server espone i propri metadati all’indirizzo:

• https://api.gpt.space/.well-known/oauth-protected-resource/servers/<name>/mcp
• https://api.gpt.space/.well-known/oauth-authorization-server/servers/<name>/mcp

La registrazione dinamica dei client è supportata, quindi il tuo agente non necessita di un client id pre-registrato. Una richiesta senza un token valido riceve un 401 con un header WWW-Authenticate che rimanda ai metadati sopra indicati.