Pular para o conteúdo

Conecte o Cursor e outros clientes

Cada servidor do GPT Workspace se comunica via HTTP com streaming e OAuth 2.0, portanto qualquer cliente que suporte servidores MCP remotos pode usá-lo. A única coisa a configurar é a URL; o cliente descobre os endpoints de OAuth por conta própria e abre a página de login do Google na primeira vez.

Abra Configurações do Cursor ➤ MCP e clique em Adicionar novo servidor MCP global, ou edite ~/.cursor/mcp.json (global) ou .cursor/mcp.json em um projeto:

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

Salve, depois clique em Conectar ou no link de login ao lado do servidor nas configurações do MCP. Após a tela de consentimento do Google, as ferramentas aparecem com um ponto verde.

Execute MCP: Add Server na paleta de comandos, escolha HTTP, cole a URL e um nome. Ou adicione ao .vscode/mcp.json:

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

Clique em Iniciar ao lado do servidor e faça login com o Google quando solicitado.

Use a mesma estrutura: uma entrada de servidor com uma url (alguns clientes chamam o campo de serverUrl ou precisam de "type": "streamable-http"). Verifique a documentação do seu cliente para os nomes exatos das chaves.

Alguns clientes apenas executam comandos locais. Faça a ponte do servidor remoto com mcp-remote, que lida com o fluxo de OAuth no seu navegador e mantém o token:

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

Use qualquer SDK de MCP com o transporte HTTP com streaming e um provedor de cliente OAuth. O servidor expõe seus metadados em:

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

O registro dinâmico de clientes é suportado, portanto seu agente não precisa de um ID de cliente pré-registrado. Uma solicitação sem um token válido recebe um erro 401 com um cabeçalho WWW-Authenticate que aponta para os metadados acima.