Zum Inhalt springen

Cursor und andere Clients verbinden

Jeder GPT Workspace-Server kommuniziert über HTTP-Streaming mit OAuth 2.0, sodass jeder Client, der Remote-MCP-Server unterstützt, ihn nutzen kann. Das Einzige, was konfiguriert werden muss, ist die URL; der Client ermittelt die OAuth-Endpunkte selbst und öffnet bei der ersten Nutzung die Google-Anmeldeseite.

Öffnen Sie Cursor Settings ➤ MCP und klicken Sie auf Add new global MCP server, oder bearbeiten Sie ~/.cursor/mcp.json (global) oder .cursor/mcp.json in einem Projekt:

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

Speichern Sie die Datei, und klicken Sie dann auf Connect oder auf den Anmeldelink neben dem Server in den MCP-Einstellungen. Nach dem Google-Zustimmungsbildschirm werden die Tools mit einem grünen Punkt angezeigt.

Führen Sie MCP: Add Server über die Befehlspalette aus, wählen Sie HTTP, und fügen Sie die URL und einen Namen ein. Oder fügen Sie Folgendes zu .vscode/mcp.json hinzu:

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

Klicken Sie auf Start neben dem Server und melden Sie sich bei Aufforderung mit Google an.

Verwenden Sie dieselbe Struktur: einen Server-Eintrag mit einer url (einige Clients nennen das Feld serverUrl oder benötigen "type": "streamable-http"). Konsultieren Sie die Dokumentation Ihres Clients bezüglich der genauen Schlüsselnamen.

Einige Clients führen nur lokale Befehle aus. Brücken Sie den Remote-Server mit mcp-remote, der den OAuth-Ablauf in Ihrem Browser abwickelt und das Token speichert:

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

Verwenden Sie ein beliebiges MCP-SDK mit dem HTTP-Streaming-Transport und einem OAuth-Client-Provider. Der Server stellt seine Metadaten unter folgenden Adressen bereit:

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

Dynamische Client-Registrierung wird unterstützt, sodass Ihr Agent keine vorregistrierte Client-ID benötigt. Eine Anfrage ohne gültiges Token erhält eine 401-Antwort mit einem WWW-Authenticate-Header, der auf die oben genannten Metadaten verweist.