Ir al contenido

Desarrolladores

Herramientas MCP

Qué puede llamar un asistente conectado a tu cuenta, con el permiso y el tipo de acceso de cada herramienta.

Resumen

El servidor MCP ofrece 62 herramientas en 9 áreas: 30 de solo lectura y 32 que modifican datos. Para conectar un cliente, mira Servidor MCP.

  • Ninguna herramienta lee y escribe a la vez: cada una es de solo lectura o modifica datos.
  • Las herramientas que modifican datos van marcadas como tales, así que clientes como Claude te piden confirmación antes de usarlas.
  • Cada herramienta exige un permiso del catálogo. Solo ves las que el rol de la conexión cubre; BMC vuelve a comprobar el permiso en cada llamada.
  • Las que llevan la marca «Acción crítica» (emitir, enviar, anular y similares) solo las puede usar una conexión con rol Personalizado que las conceda.

Herramientas por área

Contactos

Herramienta Qué hace Acceso Permiso
contacts_list Busca y lista contactos por nombre, correo o NIF, con paginación. Solo lectura contacts:contacts.read
contacts_create Crea un contacto. Si ya existe (por NIF, correo o teléfono), devuelve el existente en lugar de duplicarlo. Modifica datos contacts:contacts.create
accounts_relationships_list Lista las relaciones de una cuenta del CRM (cliente, proveedor, socio…) con su estado y sus fechas. Solo lectura contacts:accounts.read
accounts_relationship_set Añade o cambia una relación de una cuenta del CRM, por ejemplo marcarla como proveedor. Repetir la llamada no la duplica. Modifica datos contacts:accounts.update
accounts_relationship_remove Quita una relación de una cuenta del CRM. Para conservar el historial, márquela como inactiva en su lugar. Modifica datos contacts:accounts.update

Ventas

Herramienta Qué hace Acceso Permiso
billing_list Lista documentos de venta: facturas, proformas y otros. Solo lectura sales:invoices.read
billing_record_payment Registra un cobro recibido fuera de la plataforma sobre una factura. Modifica datos Acción crítica sales:invoices.pay
billing_get Consulta un documento de venta con sus líneas, impuestos y cobros. Solo lectura sales:invoices.read
billing_convert Convierte un documento en factura borrador, igual que el botón «Convertir a factura» del área de cliente. Modifica datos sales:invoices.create
billing_finalize Emite un borrador como factura, con numeración fiscal correlativa. Modifica datos Acción crítica sales:invoices.issue
billing_update_draft Modifica un borrador de venta. Una factura ya emitida no se edita: se rectifica. Modifica datos sales:invoices.update
issuer_profiles_list Lista los perfiles de emisión de facturas de una sociedad. Solo lectura sales:issuer_profiles.read
issuer_profiles_create Crea un perfil de emisión con su serie de numeración. Modifica datos sales:issuer_profiles.create
issuer_profiles_update Modifica parcialmente un perfil de emisión. Modifica datos sales:issuer_profiles.update
billing_import_historical Carga facturas ya emitidas y contabilizadas fuera de la plataforma, sin duplicar las existentes. Modifica datos Acción crítica sales:invoices.import

Compras

Herramienta Qué hace Acceso Permiso
suppliers_import_historical Carga facturas recibidas ya contabilizadas fuera de la plataforma, sin duplicar las existentes. Modifica datos Acción crítica purchases:documents.import

Contabilidad

Herramienta Qué hace Acceso Permiso
books_journal_batch Registra asientos de partida doble por lotes (hasta 500). Todo o nada. Modifica datos accounting:journal.create
books_journal_post Contabiliza asientos en borrador por lotes (hasta 50), con las mismas comprobaciones que el panel y el resultado de cada asiento. Modifica datos Acción crítica accounting:journal.post
books_accounts_upsert Crea o actualiza cuentas del catálogo contable por lotes (hasta 2.000). Modifica datos accounting:ledger_accounts.create
books_fixed_assets_list Lista los activos fijos de una sociedad. Solo lectura accounting:fixed_assets.read
books_fixed_assets_create Da de alta un activo fijo. Es idempotente. Modifica datos accounting:fixed_assets.create
books_fiscal_years_list Lista los ejercicios contables de una sociedad. Solo lectura accounting:fiscal_years.read
books_completeness Estado de los libros por sociedad y ejercicio: banco, facturas emitidas y recibidas, asientos, impuestos y saldos. Solo lectura accounting:reports.read
books_fiscal_years_create Crea ejercicios contables con sus periodos. Es idempotente. Modifica datos accounting:fiscal_years.create

Fiscal

Herramienta Qué hace Acceso Permiso
compliance_matrix Matriz de modelos por periodo: lo que corresponde según el perfil fiscal y lo ya presentado. Solo lectura tax:obligations.read
compliance_overview Resumen del cumplimiento fiscal por sociedad. Solo lectura tax:obligations.read
fiscal_position Posición fiscal del ejercicio calculada desde el diario: IVA por trimestre y retenciones. Solo lectura tax:returns.read
fiscal_justificante_url Devuelve la dirección de descarga del justificante de una declaración presentada. Solo lectura tax:returns.read
fiscal_profile_get Consulta el perfil fiscal de una sociedad. Solo lectura tax:profile.read
fiscal_profile_update Crea o actualiza el perfil fiscal: domicilio, actividad, representante y regímenes de IVA e IS. Modifica datos tax:profile.update

Laboral

Herramienta Qué hace Acceso Permiso
laboral_workers_list Lista los trabajadores de una sociedad con sus datos de Seguridad Social. Solo lectura payroll:workers.read
laboral_workers_upsert Da de alta o actualiza trabajadores por lotes (hasta 500), por sociedad y DNI. Modifica datos payroll:workers.create

Firma

Herramienta Qué hace Acceso Permiso
sign_envelope_create Crea un sobre de firma en borrador. Modifica datos sign:envelopes.create
sign_document_upload Adjunta un PDF (en base64) a un sobre en borrador. Modifica datos sign:envelopes.update
sign_participant_add Añade un firmante o aprobador a un sobre en borrador. Modifica datos sign:envelopes.update
sign_field_place Coloca un campo (firma, iniciales, texto, casilla o fecha) en unas coordenadas exactas del documento. Modifica datos sign:envelopes.update
sign_envelope_send Envía el sobre: pasa de borrador a activo e invita a los participantes por correo. Modifica datos Acción crítica sign:envelopes.send
sign_envelope_status Estado completo de un sobre: ciclo de vida y estado de cada participante. Solo lectura sign:envelopes.read
sign_envelopes_list Lista sobres con paginación, con filtro opcional por estado. Solo lectura sign:envelopes.read
sign_envelope_void Cancela un sobre activo (no avisa a los participantes). Modifica datos Acción crítica sign:envelopes.void
sign_envelope_reissue Crea un sobre nuevo a partir de uno anulado o caducado, conservando participantes y documentos. Modifica datos Acción crítica sign:envelopes.reissue
sign_pdf_download Descarga el PDF de un documento del sobre, en base64. Solo lectura sign:evidence.read
sign_evidence_download Descarga el paquete de evidencias del sobre: PDF firmado y trazas de cada participante. Solo lectura sign:evidence.read
sign_verify Verifica un documento firmado a partir del código impreso en él. Solo lectura sign:verification.read
notify_certified Envía un correo o SMS certificado y devuelve el paquete de evidencias sellado. Modifica datos Acción crítica sign:certified_mail.send
sign_envelope_pause_reminders Pausa los recordatorios diarios de un sobre hasta una fecha. Modifica datos sign:envelopes.update
sign_envelope_remind Recuerda la firma a quienes aún no han firmado un sobre enviado, sin volver a invitarlos ni cambiar los enlaces. Modifica datos Acción crítica sign:envelopes.send
sign_envelope_by_token Consulta un sobre a partir del enlace o token de firma. Solo lectura sign:envelopes.read

Doctrina y normativa

Herramienta Qué hace Acceso Permiso
dgt_get Consulta íntegra de una consulta vinculante de la DGT por su identificador (por ejemplo V2318-25). Solo lectura knowledge:dgt.read
dgt_search Busca en el corpus de consultas vinculantes de la DGT con filtros. Solo lectura knowledge:dgt.read
dgt_by_topic Lista las consultas vinculantes de la DGT etiquetadas con un tema. Solo lectura knowledge:dgt.read
dgt_evolution Análisis de cómo ha evolucionado el criterio de la DGT sobre un tema. Solo lectura knowledge:dgt.read
dgt_stats Estadísticas del corpus de la DGT y fecha hasta la que está al día. Solo lectura knowledge:dgt.read
search_query Búsqueda híbrida (por palabras y por significado) en documentos, expedientes, correos y contactos. Solo lectura knowledge:search.read
search_source_get Texto completo de una fuente del índice de búsqueda (un documento, una consulta de la DGT) por el id que trae cada resultado. Ve lo mismo que la búsqueda. Solo lectura knowledge:search.read

Desarrolladores

Herramienta Qué hace Acceso Permiso
tokens_list Lista las credenciales de la cuenta. Solo lectura developers:tokens.read
tokens_get Consulta una credencial: permisos, cuenta, IPs permitidas, límites y caducidad. Solo lectura developers:tokens.read
tokens_create Crea una credencial para la cuenta. Modifica datos developers:tokens.create
tokens_update Modifica una credencial: nombre, permisos, IPs, límites o caducidad. Modifica datos developers:tokens.update
tokens_rotate Genera un valor nuevo para una credencial; el anterior deja de servir. Modifica datos Acción crítica developers:tokens.rotate
tokens_revoke Revoca una credencial de forma definitiva. Modifica datos developers:tokens.delete
api_usage_get Consulta el uso de la API: llamadas por ventana de tiempo o el mes en curso. Solo lectura developers:usage.read
Reservar primera reunión gratuita