Перейти к содержимому

Подключение Cursor и других клиентов

Каждый сервер GPT Workspace поддерживает потоковый HTTP с OAuth 2.0, поэтому его может использовать любой клиент, поддерживающий удалённые серверы 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"
}
}
}

Сохраните изменения, затем нажмите Connect или ссылку для входа рядом с сервером в настройках MCP. После экрана согласия 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 при появлении запроса.

Используйте ту же структуру: запись сервера с полем url (в некоторых клиентах поле называется serverUrl или требуется "type": "streamable-http"). Сверьтесь с документацией вашего клиента, чтобы узнать точные имена ключей.

Некоторые клиенты работают только с локальными командами. Свяжите удалённый сервер через mcp-remote: этот инструмент обрабатывает поток OAuth в браузере и сохраняет токен:

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

Используйте любой SDK MCP с потоковым HTTP-транспортом и провайдером OAuth-клиента. Сервер предоставляет свои метаданные по адресам:

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

Поддерживается динамическая регистрация клиента, поэтому вашему агенту не нужен предварительно зарегистрированный идентификатор клиента. Запрос без действительного токена получает ответ 401 с заголовком WWW-Authenticate, который указывает на метаданные выше.