Servidor MCP | BriefPanel

A BriefPanel é um servidor MCP remoto. Conecte-o ao Cursor, ao Claude Code, ao Windsurf ou a qualquer coisa que fale o Model Context Protocol, e seu agente já pode monitorar páginas e ler o que mudou.

Esta é a referência técnica. Para uma visão geral do que a integração resolve, veja a página do MCP.

Endpoint

https://actions.briefpanel.com/mcp

Transporte — Streamable HTTP, sem estado: uma requisição JSON-RPC por POST, respondida com JSON. Server-Sent Events está descontinuado e não é necessário.
Versão do protocolo — 2024-11-05, anunciada no handshake initialize.

Um documento de descoberta é publicado em https://briefpanel.com/.well-known/mcp.json, então hosts MCP que descobrem servidores por domínio encontram o nosso sem configuração.

Autenticação

Envie uma chave pessoal de API como token Bearer:

Authorization: Bearer YOUR_BRIEFPANEL_API_KEY

Crie uma chave em Configurações → API e integrações no app (https://app.briefpanel.com/connect-agent). As chaves começam com bp_mcp_ e a mesma chave vale para a API REST.

Uma chave ausente ou inválida devolve 401 com o cabeçalho WWW-Authenticate.

Escopos

Cada chave carrega escopos. As tools de leitura exigem read; add_source exige write. Chamar uma tool para a qual a chave não tem escopo falha, em vez de não fazer nada silenciosamente.

OAuth

Conectores personalizados do Claude.ai e do Claude Desktop, e conectores do ChatGPT, exigem OAuth. Esse fluxo está a caminho; até lá, use qualquer cliente capaz de enviar um cabeçalho Bearer com a configuração abaixo.

Tokens de acesso OAuth (bp_oat_) são vinculados ao público (audience) do recurso MCP, então autenticam apenas chamadas MCP — não a API REST.

Configuração do cliente

A maioria dos clientes lê o bloco padrão mcpServers:

{
  "mcpServers": {
    "briefpanel": {
      "url": "https://actions.briefpanel.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_BRIEFPANEL_API_KEY" }
    }
  }
}

No Claude Code é um comando só:

claude mcp add --transport http briefpanel https://actions.briefpanel.com/mcp \
  --header "Authorization: Bearer YOUR_BRIEFPANEL_API_KEY"

O Cursor tem um link de instalação em um clique na página do MCP.

Tools

Cinco tools, quatro delas somente de leitura.

`list_sources`

Lista as páginas que você monitora. Sem argumentos.

`get_source_changes`

Mudanças recentes nas suas páginas monitoradas, com resumos por IA do que mudou.

Argumento	Tipo	Observações
`limit`	number	Máximo de itens a inspecionar, de 1 a 25. Padrão 10.

`get_credit_balance`

Seus créditos restantes. Cada verificação de página consome créditos. Sem argumentos.

`whoami`

A identidade e os escopos ligados à chave de API atual — útil para confirmar a que conta uma chave pertence. Sem argumentos.

`add_source`

Começa a monitorar uma nova página. É a única tool que escreve, e exige o escopo write. Verificar a página depois consome créditos.

Argumento	Tipo	Observações
`url`	string	Obrigatório. A URL da página a monitorar.
`userPrompt`	string	Quais mudanças importam, em linguagem natural.
`monitoringFrequency`	number	Minutos entre verificações. Padrão 60, limitado entre 5 minutos e 7 dias.
`notificationsEnabled`	boolean	Se deve notificar em mudanças. Padrão `false`.

Chamar de novo com a mesma URL e o mesmo userPrompt devolve a fonte existente em vez de criar uma duplicata.

Lendo o histórico

As tools MCP são feitas para conversa: elas respondem "o que mudou recentemente" em um formato que um agente consegue resumir. Para o histórico tipado completo de um item — cada atualização registrada, com valores antes/depois e a evidência capturada — use a API REST.