MCP

Probara expone un servidor Model Context Protocol (MCP) en:

https://probara.net/mcp

Cualquier cliente compatible con MCP (un asistente de IA o un IDE) puede conectarse a este endpoint para llamar a las herramientas de gestión de pruebas de Probara — proyectos, suites, casos de prueba, ejecuciones, defectos y más. Consulta la referencia de herramientas MCP para ver la lista completa y generada de todas las herramientas disponibles.

Autenticación

/mcp acepta cualquiera de los dos tipos de credencial como Bearer — consulta Autenticación API para la comparación completa:

OAuth 2.1 (recomendado para clientes interactivos como Claude.ai, Claude Code, Cursor, ChatGPT) — el cliente descubre el servidor, se registra a sí mismo y una persona aprueba el acceso mediante una pantalla de consentimiento. No hay que copiar/pegar ningún secreto.
Token API (recomendado para scripts e integraciones sin interfaz) — un token de larga duración probara_... creado en Workspace → API tokens, pegado directamente en el campo Bearer/Authorization del cliente.

Cada petición a /mcp sin credencial válida devuelve 401 con una cabecera WWW-Authenticate: Bearer resource_metadata="https://probara.net/.well-known/oauth-protected-resource" que apunta al descubrimiento del cliente.

Claude.ai (conector personalizado)

Abre Settings → Connectors → Add custom connector.
Introduce la URL del servidor: https://probara.net/mcp.
Claude.ai descubre automáticamente los metadatos de OAuth, se registra a sí mismo (Dynamic Client Registration) y te redirige a la pantalla de consentimiento de Probara.
Elige la organización a la que vincular la conexión y aprueba. Claude.ai ahora tiene una concesión OAuth limitada a esa organización.

Claude Code

Añade el servidor: claude mcp add --transport http probara https://probara.net/mcp.
Claude Code abre una ventana del navegador para el flujo de autorización/consentimiento de OAuth (mismo descubrimiento + DCR que Claude.ai).
Aprueba los scopes negociados y elige una organización. Si el cliente omite scope o envía un valor que Probara no reconoce, se aplica por defecto el conjunto completo soportado (mcp:read mcp:write); consulta Scopes para las reglas exactas de negociación.
Verifica la conexión: claude mcp list debería mostrar probara como conectado.

Cursor

Abre Settings → MCP → Add new MCP server.
Elige el transporte HTTP y define la URL como https://probara.net/mcp.
Cursor sigue el mismo flujo de descubrimiento OAuth/DCR/consentimiento; alternativamente, pega un token API en el campo de cabecera Bearer/Authorization del conector si tu versión de Cursor aún no soporta MCP OAuth.

ChatGPT

Abre Settings → Connectors → Add MCP server (Developer Mode / conectores personalizados).
Define la URL del servidor como https://probara.net/mcp.
Completa el flujo de consentimiento OAuth, o proporciona un token API como cabecera Bearer si tu plan de ChatGPT solo soporta conectores de cabecera estática.

Solución de problemas

Síntoma	Causa probable
`401` inmediato, sin ventana del navegador	El cliente no soporta el descubrimiento OAuth de MCP — usa un token API en su lugar
La pantalla de consentimiento muestra la organización equivocada	Elige otra organización en el selector de la pantalla de consentimiento antes de aprobar; cada concesión se vincula a exactamente una organización
Una llamada a herramienta devuelve `forbidden`	La concesión OAuth solo tiene `mcp:read`, o tu rol en esa organización ya no permite escritura — consulta Autenticación
`429 too_many_requests`	Se alcanzó el límite de tasa por token o por organización — espera y reintenta