Model Context Protocol

Conectar um cliente MCP ao pastebin.ca

Endpoint

URL do servidor

Aponte seu cliente MCP para:

https://pastebin.ca/mcp

Documentos de descoberta (não precisam de configuração no cliente):

/.well-known/oauth-protected-resource/mcp — Metadados de Recurso Protegido (RFC 9728)
/.well-known/oauth-authorization-server — Metadados do Servidor de Autorização (RFC 8414)

Autenticação

Duas formas de autenticar

O servidor MCP do pastebin.ca aceita OAuth 2.1 (recomendado para clientes desktop) ou uma chave API bearer de longa duração (recomendada para automação no servidor).

OAuth 2.1 + PKCE — A maioria dos clientes MCP modernos (Claude Desktop, Cursor, Inspector) descobre isso automaticamente. Eles se registram dinamicamente (RFC 7591), abrem uma página de login por passkey com consentimento e recebem um token vinculado à audiência. Sem configuração manual.
Chave API estática — Crie uma chave em Conta → Tokens de automação.

Nota: este é um servidor MCP HTTP em streaming sem estado. Requisições GET para SSE não são intencionalmente suportadas — todo o tráfego é JSON-RPC sobre POST /mcp.

Clientes

Claude Desktop

Edite ~/Library/Application Support/Claude/claude_desktop_config.json (ou no Linux ~/.config/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "pastebin": {
      "url": "https://pastebin.ca/mcp"
    }
  }
}

Na primeira utilização, o Claude abre uma aba do navegador onde você faz login com um passkey e aprova os scopes solicitados. O token é armazenado localmente; o servidor só vê o bearer em cada chamada MCP.

Cursor / Windsurf

Edite ~/.cursor/mcp.json:

{
  "mcpServers": {
    "pastebin": { "url": "https://pastebin.ca/mcp" }
  }
}

MCP Inspector

Inicie o inspector oficial contra a URL ao vivo:

npx @modelcontextprotocol/inspector

Informe https://pastebin.ca/mcp como URL do servidor e escolha OAuth quando solicitado.

Configuração manual com chave API

Se o seu cliente não fala OAuth, passe-lhe diretamente um cabeçalho bearer:

{
  "mcpServers": {
    "pastebin": {
      "url": "https://pastebin.ca/mcp",
      "headers": { "Authorization": "Bearer pbca_live_…" }
    }
  }
}

Ferramentas

O que os clientes MCP podem fazer

Use tools/list para descobrir toda a superfície — cada ferramenta vem com um inputSchema, um outputSchema e uma descrição legível. Inventário atual:

create_paste — criar uma publicação em texto simples. O corpo pode ser enviado como texto UTF-8 (body) ou como bytes UTF-8 codificados em base64 (body_b64).
get_paste — obter uma publicação sua ou qualquer publicação pública. body_format=base64 devolve os bytes brutos como body_b64 para transporte seguro.
get_encrypted_paste — obter o texto cifrado e metadados de cifra de uma publicação criptografada; decifre fora de banda.
list_my_pastes — paginar suas próprias publicações, com um next_cursor opaco.
amend_paste — adicionar uma nova versão a uma linhagem de publicação, com title e change_note opcionais.
update_visibility — alternar uma publicação em texto simples entre public e unlisted (publicações criptografadas e de leitura única são imutáveis).
delete_paste — exclusão lógica de uma publicação sua.

Os fluxos de destinatários (envio para e leitura de caixas de entrada) não são expostos pelo MCP intencionalmente porque o servidor manteria texto simples brevemente durante a selagem — use a API REST para esses casos.

Recursos

URIs de recurso paste://

A capacidade de recursos do MCP permite que clientes endereçam qualquer publicação por URI. O modelo é:

paste://{id}

resources/read devolve o corpo como parte de texto (quando UTF-8 válido) ou como parte blob base64 (binário). A autorização espelha get_paste: proprietários podem ler qualquer uma das suas publicações; qualquer pessoa pode ler publicações públicas.

Links de visualização do pastebin.ca que sigam o padrão canônico de id (10 caracteres, primeiro caractere 2-9) também são aceitos — clientes podem passar URLs https://pastebin.ca/{id} em qualquer lugar onde o protocolo espera URIs paste://{id}, e ferramentas que recebem um id (get_paste, amend_paste, update_visibility, delete_paste) aceitam as três formas.

resources/list devolve vazio por projeto — publicações não são enumeradas como recursos. Use list_my_pastes para descoberta.

Scopes

Tokens OAuth podem solicitar um subconjunto desses scopes; a página de consentimento mostra quais o cliente pediu.

paste:create — criar novas publicações
paste:read — ler publicações que você possui ou de que tem o link
paste:list — listar suas próprias publicações
paste:edit — alterar suas publicações e trocar a visibilidade entre public e unlisted
paste:revoke — excluir suas publicações

Revogar acesso

Todos os tokens emitidos para clientes MCP aparecem em Aplicativos conectados na página da sua conta. Clique em Revogar para invalidar o token imediatamente — o cliente terá que refazer o fluxo OAuth na próxima chamada.