Kết nối Cursor và các trình khách khác

Mọi máy chủ GPT Workspace đều giao tiếp qua HTTP streamable với OAuth 2.0, nên bất kỳ trình khách nào hỗ trợ máy chủ MCP từ xa đều có thể sử dụng. Việc duy nhất cần cấu hình là URL; trình khách sẽ tự khám phá các endpoint OAuth và mở trang đăng nhập của Google trong lần đầu tiên.

Mở Cursor Settings ➤ MCP và nhấp Add new global MCP server, hoặc chỉnh sửa ~/.cursor/mcp.json (toàn cục) hoặc .cursor/mcp.json trong một dự án:

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

Lưu lại, sau đó nhấp Connect hoặc liên kết đăng nhập bên cạnh máy chủ trong cài đặt MCP. Sau màn hình đồng ý của Google, các công cụ sẽ hiển thị với dấu chấm màu xanh.

Chạy MCP: Add Server từ bảng lệnh, chọn HTTP, dán URL và tên. Hoặc thêm vào .vscode/mcp.json:

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

Nhấp Start bên cạnh máy chủ và đăng nhập bằng Google khi được nhắc.

Sử dụng cùng cấu trúc: một mục máy chủ với url (một số trình khách gọi trường này là serverUrl hoặc cần "type": "streamable-http"). Xem tài liệu của trình khách để biết tên khóa chính xác.

Một số trình khách chỉ chạy lệnh cục bộ. Kết nối máy chủ từ xa thông qua mcp-remote, công cụ này xử lý luồng OAuth trong trình duyệt và lưu token:

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

Sử dụng bất kỳ SDK MCP nào với giao thức vận chuyển HTTP streamable và nhà cung cấp trình khách OAuth. Máy chủ công khai siêu dữ liệu của nó tại:

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

Đăng ký trình khách động được hỗ trợ, nên tác nhân của bạn không cần client id đã đăng ký sẵn. Một yêu cầu không có token hợp lệ sẽ nhận phản hồi 401 kèm header WWW-Authenticate trỏ đến siêu dữ liệu ở trên.