Help Center

← Back to Help Center

Neste artigo

Servidor Model Context Protocol (MCP)

O Servidor Model Context Protocol (MCP) do Glubler permite que os grandes modelos de linguagem (OpenAI ChatGPT, Anthropic Claude, Claude Desktop, Chatbox, Cursor e agentes de IA próprios) interajam diretamente com as suas coleções Glubler, pesquisem no catálogo de sites registados, colem os sites em falta e organizem o conteúdo através de comandos em linguagem natural.

2. Pontos de extremidade oficiais do servidor

A infraestrutura MCP do Glubler funciona tanto com pontos de extremidade de streaming remoto alojados como com serviços de descoberta OAuth 2.1 padrão:

Serviço URL / Ponto de extremidade Especificação
Servidor MCP (SSE) https://mcp.glubler.com/sse Transporte remoto Server-Sent Events (SSE)
Ponto de extremidade Messages https://mcp.glubler.com/messages Processador de mensagens JSON-RPC 2.0
Protected Resource Metadata https://glubler.com/.well-known/oauth-protected-resource Descoberta RFC 9728
Servidor de autorização OAuth 2.1 https://glubler.com/.well-known/openid-configuration Descoberta RFC 8414
Ponto de extremidade Authorize https://glubler.com/connect/authorize OAuth 2.1 Code Flow + PKCE (S256)
Ponto de extremidade Token https://glubler.com/connect/token Troca e renovação do token

3. Fluxo de autenticação OAuth 2.1 e PKCE

Para plataformas de IA na nuvem como o OpenAI e a Anthropic, o Glubler implementa a especificação oficial OAuth 2.1 com Proof Key for Code Exchange (PKCE S256) obrigatório:

  • Proteção PKCE: Protege contra ataques de interceptação do código de autorização sem exigir segredos de cliente em clientes públicos.
  • Concessões isoladas: As sessões normais de utilizador em www.glubler.com permanecem independentes; a autorização é concedida estritamente ao cliente de IA.
  • Controlo do âmbito: O âmbito predefinido mcp:all permite gerir coleções e marcadores em nome do utilizador.

Token de acesso pessoal (token estático)

Os utilizadores também podem gerar diretamente nas definições do Glubler um token MCP pessoal dedicado, válido por 30 dias, sem janelas de pop-up do navegador:

  1. Aceda a glubler.com/settings.
  2. Selecione o separador MCP Server na barra lateral.
  3. Clique em Generate MCP / API Token e copie o token.
  4. Forneça-o como cabeçalho HTTP: Authorization: Bearer YOUR_TOKEN.

4. Ferramentas MCP disponíveis

Depois de ligado, o modelo de IA tem acesso às seguintes 10 ferramentas estruturadas:

Nome da ferramenta Descrição Plano necessário
search_glubler_catalog Pesquisa na base de dados do Glubler sites, fontes de notícias, jogos e ferramentas existentes. Gratuito
list_my_glublers Lista todas as coleções (glublers) e subglublers aninhados da conta autenticada. Gratuito
get_glubler_details Obtém o conteúdo completo de uma coleção, incluindo sites guardados, notas e subglublers. Gratuito
get_public_glubler Consulta qualquer lista Glubler pública através de username e slugName (sem necessidade de autenticação). Gratuito
create_glubler Cria uma coleção nova. Quando parentGlublerId é especificado (subglubler), é necessário um plano Pro. Pro para subglublers
rename_glubler Altera o título e/ou o slug de URL de uma coleção ou de um subglubler. Gratuito
delete_glubler Elimina permanentemente uma coleção e os seus itens. Gratuito
glue_website Guarda um site numa coleção. Os sites em falta são obtidos e analisados automaticamente, e o favicon é verificado. Gratuito
glue_websites_batch Guarda vários sites num único comando. O Glubler resolve as correspondências do catálogo e obtém sites externos em lote. Gratuito
unglue_website Remove um site de uma coleção. Gratuito

5. Configuração do OpenAI e do ChatGPT

Ao ligar o Glubler a um Custom GPT, a Actions ou à integração Remote MCP da OpenAI:

  • URL do servidor: https://mcp.glubler.com/sse
  • Tipo de autenticação: OAuth 2.0 / OAuth 2.1
  • URL de autorização: https://glubler.com/connect/authorize
  • URL do token: https://glubler.com/connect/token
  • Âmbito: mcp:all offline_access
  • PKCE: Ativado (S256)

6. Configuração do Claude e do Claude Desktop

Configuração do Claude Desktop

Adicione o servidor remoto diretamente ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "glubler": {
      "url": "https://mcp.glubler.com/sse",
      "headers": {
        "Authorization": "Bearer YOUR_GLUBLER_TOKEN"
      }
    }
  }
}

7. Clientes de ambiente de trabalho (Chatbox, OpenCowork, Cursor)

Para o Chatbox ou qualquer cliente de IA de ambiente de trabalho que suporte Remote MCP sobre HTTP/SSE:

  1. Abra a janela MCP Settings.
  2. Defina Type como Remote (http/sse).
  3. Defina Protocol como Legacy (transporte SSE padrão).
  4. Defina URL como https://mcp.glubler.com/sse.
  5. Defina HTTP Header como Authorization=Bearer YOUR_GLUBLER_TOKEN.
  6. Clique em Connect e depois em Save.

8. Aplicação dos planos Free e Pro

O Glubler oferece capacidades generosas no plano gratuito, enquanto a hierarquia aninhada avançada está reservada aos membros Pro:

  • Plano Free / Standard: Coleções Glubler de primeiro nível ilimitadas, pesquisa no catálogo, colagem de sites, importações em lote, partilha social e mudança de nome.
  • Plano Pro (4,32 $/mês): Subglublers aninhados (até 7 níveis de profundidade). Se um utilizador do plano gratuito pedir a uma IA que crie um subglubler, o servidor devolve PRO_PLAN_REQUIRED, e a IA orienta o utilizador para a atualização em glubler.com/settings.

9. Segurança e privacidade

  • Sem fuga de credenciais: Os tokens MCP estão estritamente associados à conta de utilizador que os emitiu e nunca expõem os glublers privados de outros utilizadores.
  • Análise segura: Todos os sites externos são higienizados e verificados face às políticas de qualidade e segurança do Glubler antes de os favicons e os metadados serem armazenados.
  • Acesso revogável: Gerar um novo token ou alterar a sua palavra-passe invalida imediatamente os tokens mais antigos.