Connecter Cursor et autres clients

Chaque serveur GPT Workspace communique en HTTP streamable avec OAuth 2.0, donc tout client prenant en charge les serveurs MCP distants peut l’utiliser. La seule chose à configurer est l’URL ; le client découvre lui-même les points de terminaison OAuth et ouvre la page de connexion Google lors de la première utilisation.

Ouvrez Cursor Settings ➤ MCP et cliquez sur Add new global MCP server, ou modifiez ~/.cursor/mcp.json (global) ou .cursor/mcp.json dans un projet :

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

Enregistrez, puis cliquez sur Connect ou le lien de connexion à côté du serveur dans les paramètres MCP. Après l’écran de consentement de Google, les outils apparaissent avec un point vert.

Exécutez MCP: Add Server depuis la palette de commandes, choisissez HTTP, collez l’URL et un nom. Ou ajoutez à .vscode/mcp.json :

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

Cliquez sur Start à côté du serveur et connectez-vous avec Google lorsque vous y êtes invité.

Utilisez la même structure : une entrée de serveur avec une url (certains clients appellent ce champ serverUrl ou nécessitent "type": "streamable-http"). Consultez la documentation de votre client pour les noms exacts des clés.

Certains clients exécutent uniquement des commandes locales. Reliez le serveur distant avec mcp-remote, qui gère le flux OAuth dans votre navigateur et conserve le jeton :

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

Utilisez n’importe quel SDK MCP avec le transport HTTP streamable et un fournisseur de client OAuth. Le serveur expose ses métadonnées à :

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

L’enregistrement dynamique des clients est pris en charge, votre agent n’a donc pas besoin d’un identifiant client pré-enregistré. Une requête sans jeton valide reçoit une erreur 401 avec un en-tête WWW-Authenticate qui pointe vers les métadonnées ci-dessus.