Model Context Protocol
URL do servidor
Aponte seu cliente MCP para:
Install in VS Code MCP Registry record
Add https://pastebin.ca/mcp as a remote MCP server in your client, then sign in with your Pastebin.ca account.
In Claude, open Customize → Connectors → Add → Custom → Web, enter the URL and use Claude’s published identity when prompted.
Try it List my three most recent pastes and show their titles.
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)
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.
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_…" }
}
}
} 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.list_paste_versions— retornar a cadeia completa de alterações para qualquer publicação em uma linhagem de alterações em uma única chamada (mais antigas primeiro), com versões excluídas marcadas como excluídas no lugar.diff_pastes— retornar um unified diff padrão entre duas publicações na mesma linhagem de alterações. Apenas texto simples.search_my_pastes— busca de texto completo nas suas próprias publicações públicas; retorna trechos destacados e URIs paste://. Publicações privadas, não listadas e criptografadas nunca são indexadas.whoami— confirmar a conta autenticada, scopes e (para OAuth) o audience vinculado. Nenhum scope necessário.
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.
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.
Escopos
Tokens OAuth podem solicitar um subconjunto desses scopes; a página de consentimento mostra quais o cliente pediu.
paste:create— criar novas publicaçõespaste:read— ler publicações que você possui ou de que tem o linkpaste:list— listar suas próprias publicaçõespaste:edit— alterar suas publicações e trocar a visibilidade entre public e unlistedpaste:revoke— excluir suas publicações
Revogar acesso
Todos os tokens emitidos para clientes MCP aparecem em Aplicativos na página da sua conta. Revogar um token de acesso interrompe as solicitações que o usam. Isso não remove a autorização do aplicativo para solicitar um novo token.