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로 로그인합니다.

동일한 구조를 사용합니다: 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"]
    }
  }
}

스트리밍 가능한 HTTP 전송과 OAuth 클라이언트 프로바이더를 지원하는 모든 MCP SDK를 사용하세요. 서버는 다음 경로에서 메타데이터를 제공합니다:

• 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 응답이 반환됩니다.