Ir al contenido

Conectar Cursor y otros clientes

Cada servidor de GPT Workspace utiliza HTTP transmitible con OAuth 2.0, por lo que cualquier cliente que admita servidores MCP remotos puede usarlo. Lo único que hay que configurar es la URL; el cliente descubre los endpoints de OAuth por sí mismo y abre la página de inicio de sesión de Google la primera vez.

Abre Configuración de Cursor ➤ MCP y haz clic en Añadir nuevo servidor MCP global, o edita ~/.cursor/mcp.json (global) o .cursor/mcp.json en un proyecto:

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

Guarda, luego haz clic en Conectar o en el enlace de inicio de sesión junto al servidor en los ajustes de MCP. Tras la pantalla de consentimiento de Google, las herramientas aparecen con un punto verde.

Ejecuta MCP: Add Server desde la paleta de comandos, elige HTTP, pega la URL y un nombre. O añádelo a .vscode/mcp.json:

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

Haz clic en Start junto al servidor e inicia sesión con Google cuando se te solicite.

Usa la misma estructura: una entrada de servidor con un url (algunos clientes llaman al campo serverUrl o necesitan "type": "streamable-http"). Consulta la documentación de tu cliente para conocer los nombres exactos de las claves.

Algunos clientes solo ejecutan comandos locales. Conecta el servidor remoto con mcp-remote, que gestiona el flujo de OAuth en tu navegador y conserva el token:

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

Usa cualquier SDK de MCP con el transporte HTTP transmitible y un proveedor de cliente OAuth. El servidor expone sus metadatos en:

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

El registro dinámico de clientes es compatible, así que tu agente no necesita un id de cliente preregistrado. Una petición sin un token válido recibe un 401 con una cabecera WWW-Authenticate que apunta a los metadatos anteriores.