Brivvy MCP

Brivvy AI

Este repositorio es tu punto de entrada público para las integraciones de Brivvy AI. Aquí obtienes metadatos del servidor MCP, pasos de instalación, perfiles de conexión para clientes y notas de versión.

La implementación permanece privada. Todo lo que está aquí es seguro de publicar.

A qué te conectas

• Tipo de servidor: MCP remoto (HTTP Streamable).
• URL de producción: https://mcp.brivvy.io.
• Autenticación: Flujo estilo OAuth 2.1 con PKCE.
• Descubrimiento: Usa estos antes de llamar al endpoint JSON-RPC:
  • https://mcp.brivvy.io/.well-known/oauth-protected-resource.
  • https://mcp.brivvy.io/.well-known/oauth-authorization-server.

Herramientas en las que puedes confiar

Estos nombres de herramientas son el contrato público. Las descripciones breves coinciden con lo que el servidor alojado expone hoy (consulta Servidor MCP para guías de conexión, notas de seguridad y preguntas frecuentes).

Área	Herramienta	Qué hace
Voces	list_voices	Lista las voces publicadas en tu espacio de trabajo.
Voces	get_voice	Devuelve las reglas de tono y estilo para la voz predeterminada o una elegida.
Plantillas	list_templates	Lista las plantillas de contenido guardadas en tu espacio de trabajo.
Plantillas	list_discover_templates	Lista las plantillas públicas del catálogo de la comunidad de Brivvy.
Plantillas	get_template	Devuelve el prompt completo y las instrucciones de una plantilla que selecciones.

Inicio rápido

Cursor

Añade Brivvy como servidor MCP remoto:

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

Conéctate una vez y luego completa OAuth en el navegador cuando el cliente te lo pida.

Claude

Apunta tu conector MCP a:

• URL: https://mcp.brivvy.io.
• Transporte: HTTP Streamable.
• Autenticación: OAuth.

Claude lee los metadatos de .well-known y te guía a través del consentimiento.

Alcance del espacio de trabajo

Tu cuenta de Brivvy usa un espacio de trabajo a la vez para MCP. El espacio de trabajo que elegiste por última vez en la pantalla de OAuth se aplica a todos los clientes MCP hasta que autorices de nuevo y elijas uno diferente. Si ejecutas Cursor y Claude en paralelo, hoy no mantienen selecciones de espacio de trabajo separadas.

Sesiones y reconexión

Tu token de acceso tiene una vida corta. El cliente debe renovarlo con tu token de actualización. Los tokens de actualización duran 90 días (Amazon Cognito). Cuando termine ese período, conéctate de nuevo y completa el flujo OAuth.

Cuando algo falla

• 401 en POST /: Normal antes de OAuth. Tu cliente debe seguir la pista de WWW-Authenticate y completar el descubrimiento.
• Desconexiones justo después del consentimiento: Revisa la URL de callback, inténtalo una vez más y asegúrate de haber completado la ventana emergente de OAuth.
• Errores de token: Reconéctate para obtener un token bearer nuevo. No reutilices un token de sesión web antiguo.
• Sin herramientas listadas: Tu consentimiento MCP o acceso al espacio de trabajo puede faltar o haber expirado.
• Espacio de trabajo incorrecto: Reconéctate y elige el espacio de trabajo que quieras en la pantalla de OAuth. Esa elección se aplica a todos los clientes MCP de tu cuenta.

Qué hay aquí

• mcp/server.json, metadatos del registro.
• mcp/install/, perfiles de Cursor y Claude.
• VERSIONING.md, cómo versionamos estos metadatos públicos.
• CHANGELOG.md, notas de versión.
• SECURITY.md, cómo informar problemas.

Los flujos internos de publicación y directorio permanecen en el repositorio privado de Brivvy MCP.

Cómo contactarnos

• Soporte: support@brivvy.io.
• Seguridad: security@brivvy.io.