MCP open-bp: referencia para los agentes

Contratos públicos de las herramientas, secuencia de trabajo y convenciones financieras. Esta página no contiene datos de proyectos y no sustituye a la autenticación.

Leer la versión Markdown Esquemas JSON de las herramientas Guía de conexión

Conexión al servidor

https://open-bp.com/api/mcp

Transporte Streamable HTTP, solicitudes POST en JSON-RPC. El cliente negocia el protocolo con initialize y descubre las herramientas con tools/list. Cada solicitud debe estar autenticada.

OAuth utiliza el descubrimiento del recurso protegido y PKCE. Una clave personal utiliza la cabecera Authorization con Bearer. Las claves y los tokens no deben incluirse en URL, solicitudes al modelo ni registros.

Metadatos OAuth del recurso

Secuencia de trabajo de un agente

Autentique la conexión mediante OAuth o una clave privada. El catálogo público describe los contratos; no concede acceso a los proyectos.
Ejecute tools/list después de autenticarse para descubrir únicamente las herramientas autorizadas para la conexión.
Consulte project_get y project_context antes de modificar un proyecto. Utilice los identificadores, unidades, períodos y fuentes que devuelva el servidor.
Prepare un borrador con project_edit_draft o project_update con commit=false. Recalcule con project_calculate y presente las diferencias.
Guarde solo después de una solicitud explícita, con project_save o commit=true y la versión esperada. Un error de versión exige volver a consultar los datos actuales.
Trate por separado las operaciones de acceso compartido, cuenta y facturación. Compruebe los parámetros y solicite una confirmación antes de ejecutarlas.

Convenciones y controles

Los importes se expresan en euros. Los valores decimales de las hipótesis financieras son cadenas; los tipos se expresan como fracciones y los períodos de cálculo son mensuales.
Conserve los estados missing, example, estimate y confirmed de las fuentes. No invente importes, documentos, fuentes ni pruebas comerciales.
Los permisos y las cuotas se comprueban de nuevo en el servidor en cada acción. El rol admin exige una cuenta incwo verificada; un token no crea ese rol.
La conexión sigue vinculada a la sesión open-bp que la autorizó. La renovación OAuth no prolonga esa sesión; una vez caducada, es necesaria una nueva conexión.
Las exportaciones utilizan la versión guardada. Los cálculos describen hipótesis; no constituyen una validación profesional del plan.

Catálogo de herramientas MCP

Aquí se describen 68 contratos. Después de conectarse, tools/list devuelve solo las herramientas autorizadas para su identidad y sus permisos.

Para consultar un solo esquema, añada el parámetro tool al catálogo JSON, por ejemplo:

/agents/catalogue.json?tool=project_update

Herramienta	Permiso necesario	Acción y condiciones
`account_delete`	`account`	Programar o cancelar la eliminación de la cuenta tras confirmar su email. Requiere una sesión creada hace menos de diez minutos y comprueba los compromisos con Stripe.
`account_export`	`account`	Exportar los datos personales y todos los proyectos del propietario en JSON privado, sin secretos de conexión.
`account_get`	`account`	Consultar la cuenta, las conexiones disponibles y cualquier eliminación programada.
`account_link_provider`	`account`	Preparar la vinculación de Google o incwo a la cuenta. Abre el enlace y confirma con el proveedor para completarla.
`account_revoke_sessions`	`account`	Cerrar las demás sesiones de la cuenta. También se eliminan sus claves MCP.
`account_sign_out`	`account`	Cerrar la sesión que autorizó al asistente y revocar sus claves y autorizaciones activas. Requiere confirmación explícita.
`admin_accounts`	`admin`	Buscar cuentas y consultar sus permisos y últimas asignaciones. Reservado a cuentas incwo verificadas.
`admin_grant_subscription`	`admin`	Asignar una suscripción temporal con duración e historial, sin pago de Stripe. Reservado a cuentas incwo verificadas.
`admin_revoke_subscription`	`admin`	Retirar una asignación temporal y recuperar los permisos facturados. Reservado a cuentas incwo verificadas.
`assistance_history`	`read`	Leer las propuestas de redacción, las revisiones y sus cuotas.
`assistance_request`	`write`	Solicitar una redacción o revisión a OpenAI con consentimiento, cuota e identificador de reintento. Los textos siguen siendo propuestas.
`assumption_update`	`write`	Modificar el estado, la fuente y la nota de una hipótesis existente. Confirmarla requiere una fuente o una nota. commit=true guarda el cambio.
`billing_cancel_change`	`billing`	Cancelar un cambio de plan programado.
`billing_checkout`	`billing`	Crear un enlace de Stripe tras elegir un plan, un período de facturación y aceptar expresamente las condiciones. El enlace no acredita un pago.
`billing_confirm_change`	`billing`	Confirmar una previsión de cambio de plan vigente tras aceptar el importe y la fecha.
`billing_portal`	`billing`	Abrir el portal de Stripe para tarjetas, facturas y cancelación.
`billing_preview_change`	`billing`	Calcular el importe prorrateado y la fecha de un cambio de plan sin confirmarlo.
`billing_refresh`	`billing`	Conciliar la suscripción con las facturas verificadas de Stripe.
`chat_action_confirm`	`write`	Confirmar una acción concreta preparada por el chat. Comprueba la sesión, los permisos originales, la versión y la huella del borrador; los reintentos no repiten acciones terminadas.
`chat_actions_list`	`read`	Consultar las acciones preparadas por el chat para tu sesión, sus datos y su estado.
`chat_history`	`read`	Leer los intercambios privados del chat y su cuota de asistencia.
`chat_send`	`write`	Enviar un mensaje y los datos del borrador a OpenAI con consentimiento y cuota. Devuelve una propuesta comprobada sin guardar el proyecto.
`comment_add`	`write`	Añadir un comentario a una sección y a la versión actual del proyecto.
`comment_resolve`	`write`	Marcar un comentario como resuelto o reabrirlo según los permisos de la cuenta.
`comments_list`	`read`	Leer los comentarios privados del proyecto con paginación.
`cost_estimate`	`read`	Calcular un gasto con el método y los valores aportados, sin inventar un importe.
`costs_list`	`read`	Consultar los gastos y métodos de estimación disponibles.
`expense_estimate_apply`	`write`	Aplicar una estimación numérica a un gasto, conservar el método y la fuente y recalcular. commit=true guarda el cambio.
`expenses_add_standard`	`write`	Añadir los gastos elegidos del catálogo, sin inventar importes ni duplicar partidas. Los importes quedan pendientes. commit=true guarda el cambio.
`expenses_remove`	`write`	Eliminar una fila señalada expresamente y retirar sus ajustes de escenarios. commit=true guarda el cambio.
`expenses_upsert`	`write`	Añadir o modificar una fila completa de hipótesis con su identificador estable. commit=true guarda el cambio.
`invitation_accept`	`write`	Aceptar una invitación que corresponda al email verificado de la cuenta.
`invitations_list`	`read`	Listar las invitaciones dirigidas al email verificado de la cuenta.
`language_set`	`read`	Elegir el idioma de las herramientas y respuestas de esta conexión MCP. Los datos y las reglas financieras se mantienen.
`mcp_connection_create`	`access`	Crear una clave MCP tras una confirmación explícita. Solo puede delegar los permisos de la conexión actual. Guarda la clave devuelta en una configuración privada.
`mcp_connection_revoke`	`access`	Revocar una clave MCP de la cuenta tras una confirmación explícita.
`mcp_connections_list`	`access`	Listar las claves MCP de la cuenta y sus permisos sin mostrar secretos.
`monthly_evolution_set`	`write`	Sustituir o eliminar la progresión y las excepciones únicamente del campo mensual indicado. Una excepción cero sigue siendo explícita. commit=true guarda el cambio.
`oauth_connection_revoke`	`account`	Retirar la autorización OAuth de un asistente y revocar sus tokens de acceso y renovación.
`oauth_connections_list`	`account`	Listar los asistentes autorizados mediante OAuth y sus permisos, sin secretos de conexión.
`payroll_remove`	`write`	Eliminar una fila señalada expresamente y retirar sus ajustes de escenarios. commit=true guarda el cambio.
`payroll_upsert`	`write`	Añadir o modificar una fila completa de hipótesis con su identificador estable. commit=true guarda el cambio.
`portfolio_list`	`read`	Consultar el avance de los expedientes de clientes con la vista Cabinet y paginación.
`project_archive`	`write`	Archivar o reactivar un proyecto propio, comprobando su versión y la cuota.
`project_calculate`	`read`	Recalcular un borrador y comparar sus escenarios con el motor financiero.
`project_context`	`read`	Leer las rutas de campos, unidades, períodos y resultados para modificar el proyecto correcto.
`project_create`	`write`	Crear un proyecto a partir de una plantilla. El servidor comprueba la cuota de proyectos activos.
`project_edit_draft`	`write`	Modificar un borrador y recalcular los resultados sin guardar. project_context proporciona las rutas y unidades. Para guardar, usar project_save con la versión esperada.
`project_export`	`read`	Exportar la versión guardada en PDF, Word, Excel, PowerPoint, CSV (archivo ZIP), texto u hoja de cálculo OpenDocument, o HTML sin conexión. Devuelve un recurso privado y verifica los permisos de la suscripción.
`project_get`	`read`	Leer los datos guardados, la versión y los permisos del proyecto.
`project_save`	`write`	Guardar todos los campos del proyecto, fuentes, gastos, perfiles mensuales, escenarios y expediente. Requiere la versión esperada y crea una nueva revisión.
`project_update`	`write`	Modificar solo los campos solicitados del proyecto. Los grupos financieros se combinan; las listas se sustituyen. commit=false propone un borrador; commit=true guarda comprobando la versión.
`projects_list`	`read`	Buscar proyectos privados y compartidos, incluidos los archivados, con paginación.
`revenues_remove`	`write`	Eliminar una fila señalada expresamente y retirar sus ajustes de escenarios. commit=true guarda el cambio.
`revenues_upsert`	`write`	Añadir o modificar una fila completa de hipótesis con su identificador estable. commit=true guarda el cambio.
`revision_compare`	`read`	Comparar dos versiones guardadas o un borrador con una versión: hipótesis, fuentes, escenarios, expediente y resultados calculados.
`revision_get`	`read`	Consultar los datos y resultados de una versión guardada del proyecto.
`revision_restore`	`write`	Restaurar una versión guardada completa creando una nueva versión sin sobrescribir el historial.
`revisions_list`	`read`	Listar las versiones guardadas privadas del proyecto con paginación por versión.
`scenario_remove`	`write`	Eliminar el escenario señalado expresamente, incluido un escenario antiguo guardado. commit=true guarda el cambio.
`scenario_upsert`	`write`	Crear o modificar un escenario completo conservando la previsión inicial. Comprueba las cuotas y recalcula la comparación. commit=true guarda el cambio.
`share_invite`	`write`	Invitar a un editor o lector al proyecto comprobando las cuotas. Esta acción no envía ningún email.
`share_revoke`	`write`	Retirar una invitación o un acceso al proyecto para su propietario.
`shares_list`	`read`	Listar las invitaciones y los accesos del proyecto para su propietario.
`subscription_get`	`read`	Consultar el plan efectivo, los permisos pagados, las cuotas y el cambio programado.
`template_get`	`read`	Consultar una plantilla, sus actividades, preguntas e hipótesis.
`template_prepare`	`read`	Preparar un proyecto a partir de una plantilla y valores aportados sin guardar.
`templates_list`	`read`	Listar las plantillas de actividad y sus versiones. Los ejemplos son ficticios.