コンテンツにスキップ

Cursorとその他のクライアントの接続

すべてのGPT WorkspaceサーバーはOAuth 2.0とストリーミングHTTPで通信するため、リモートMCPサーバーをサポートするクライアントならどれでも利用できます。設定が必要なのはURLだけです。クライアントがOAuthエンドポイントを自動的に検出し、初回にGoogleのログインページを開きます。

Cursor Settings ➤ MCP を開き、Add new global MCP server をクリックするか、~/.cursor/mcp.json(グローバル)またはプロジェクト内の .cursor/mcp.json を編集します:

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

保存後、MCP設定でサーバー名の横にある Connect またはログインリンクをクリックします。Googleの同意画面を経ると、ツールに緑色のドットが表示されて利用可能になります。

コマンドパレットから MCP: Add Server を実行し、HTTP を選択して、URLと名前を入力します。または .vscode/mcp.json に追加します:

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

サーバー名の横にある Start をクリックし、プロンプトが表示されたらGoogleでログインします。

Windsurf、Gemini CLI、その他のクライアント

Section titled “Windsurf、Gemini CLI、その他のクライアント”

同じ構造を使用します: url を持つサーバーエントリ(一部のクライアントではフィールド名が serverUrl だったり、"type": "streamable-http" が必要な場合があります)。正確なキー名についてはクライアントのドキュメントを確認してください。

OAuthをサポートしないクライアント

Section titled “OAuthをサポートしないクライアント”

一部のクライアントはローカルコマンドのみを実行できます。mcp-remote を使ってリモートサーバーをブリッジします。これはブラウザでOAuthフローを処理し、トークンを保持します:

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

ストリーミングHTTPトランスポートとOAuthクライアントプロバイダーを備えた任意のMCP SDKを使用できます。サーバーは以下のURLでメタデータを公開しています:

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

動的クライアント登録がサポートされているため、エージェントに事前登録済みのクライアントIDは不要です。有効なトークンがないリクエストは、上記のメタデータを指す WWW-Authenticate ヘッダーと共に401を受け取ります。