Brivvy MCP

Brivvy AI

Este repositório é o seu ponto de entrada público para integrações com Brivvy AI. Você encontra metadados do servidor MCP, etapas de instalação, perfis de conexão de clientes e notas de versão.

A implementação permanece privada. Tudo aqui é seguro para publicação.

Com o que você se conecta

• Tipo de servidor: MCP remoto (Streamable HTTP).
• URL de produção: https://mcp.brivvy.io.
• Autenticação: Fluxo estilo OAuth 2.1 com PKCE.
• Descoberta: Use estes antes de chamar o endpoint JSON-RPC:
  • https://mcp.brivvy.io/.well-known/oauth-protected-resource.
  • https://mcp.brivvy.io/.well-known/oauth-authorization-server.

Ferramentas em que você pode confiar

Estes nomes de ferramentas são o contrato público. As descrições curtas correspondem ao que o servidor hospedado expõe hoje (veja Servidor MCP para guias de conexão, notas de segurança e perguntas frequentes).

Área	Ferramenta	O que faz
Vozes	list_voices	Lista vozes publicadas no seu espaço de trabalho.
Vozes	get_voice	Retorna regras de tom e estilo para a voz padrão ou uma voz escolhida.
Modelos	list_templates	Lista modelos de conteúdo salvos no seu espaço de trabalho.
Modelos	list_discover_templates	Lista modelos públicos do catálogo da comunidade Brivvy.
Modelos	get_template	Retorna o prompt completo e as instruções para um modelo que você selecionar.

Início rápido

Cursor

Adicione Brivvy como um servidor MCP remoto:

{
  "mcpServers": {
    "Brivvy": {
      "url": "https://mcp.brivvy.io"
    }
  }
}

Conecte uma vez e conclua o OAuth no navegador quando o cliente solicitar.

Claude

Aponte seu conector MCP para:

• URL: https://mcp.brivvy.io.
• Transporte: Streamable HTTP.
• Autenticação: OAuth.

O Claude lê os metadados .well-known e orienta você pelo consentimento.

Escopo do espaço de trabalho

Sua conta Brivvy usa um espaço de trabalho por vez para MCP. O espaço de trabalho que você selecionou por último na tela de OAuth se aplica a todos os clientes MCP até você autorizar novamente e escolher um diferente. Se você executar Cursor e Claude lado a lado, eles não mantêm seleções de espaço de trabalho separadas atualmente.

Sessões e reconexão

Seu token de acesso permanece de curta duração. O cliente deve renová-lo com seu token de atualização. Os tokens de atualização duram 90 dias (Amazon Cognito). Quando essa janela terminar, conecte-se novamente e execute o fluxo OAuth.

Quando algo dá errado

• 401 em POST /: Normal antes do OAuth. Seu cliente deve seguir a dica WWW-Authenticate e concluir a descoberta.
• Desconexões logo após o consentimento: Verifique a URL de callback, tente mais uma vez e certifique-se de ter concluído o popup do OAuth.
• Erros de token: Reconecte para obter um novo token bearer. Não reutilize um token de sessão web antigo.
• Nenhuma ferramenta listada: Seu consentimento MCP ou acesso ao espaço de trabalho pode estar ausente ou expirado.
• Espaço de trabalho errado: Reconecte e escolha o espaço de trabalho desejado na tela de OAuth. Essa escolha se aplica a todos os clientes MCP na sua conta.

O que está aqui

• mcp/server.json, metadados de registro.
• mcp/install/, perfis para Cursor e Claude.
• VERSIONING.md, como versionamos estes metadados públicos.
• CHANGELOG.md, notas de versão.
• SECURITY.md, como relatar problemas.

Fluxos internos de versão e diretório permanecem no repositório privado Brivvy MCP.

Como falar conosco

• Suporte: support@brivvy.io.
• Segurança: security@brivvy.io.