Developers · MCP Inspector

Inspecciona y prueba los conectores MCP de Isaak

Tres servidores MCP disponibles: Isaak, Claude para Holded y Holded para ChatGPT. El MCP Inspector te permite ver los tools en tiempo real y ejecutar llamadas directamente desde el navegador, sin instalación.

Usar el Inspector Abrir Isaak

MCP Inspector

Una sola herramienta para probar los tres conectores. Visualiza schemas, ejecuta llamadas y verifica annotations.

Tres conectores

Isaak MCP, Claude para Holded y Holded para ChatGPT. Cada uno con su preset de tools, auth y endpoints.

Referencia de tools

Las 9 tools de Isaak documentadas con tipos de entrada/salida. Referencia completa de Holded en docs del conector.

MCP Inspector

Un solo comando para depurar cualquier conector

El Inspector es la herramienta oficial del protocolo MCP. No requiere instalación permanente. Arranca en localhost:6274 y conecta a cualquier servidor MCP local o remoto.

Lanzar Inspector

npx @modelcontextprotocol/inspector@latest

Importante: la consola imprime la URL completa con el token de proxy, por ejemplo http://localhost:6274/?MCP_PROXY_AUTH_TOKEN=…. Úsala siempre, no la URL raíz sin token.

El puerto 6277 está ocupado → cómo liberarlo

Windows PowerShell

# Liberar puertos del Inspector (Windows PowerShell)
$ports = @(6274, 6277)
foreach ($port in $ports) {
  $p = (netstat -ano | Select-String ":$port ").ToString().Trim().Split()[-1]
  if ($p) { Stop-Process -Id ([int]$p) -Force -ErrorAction SilentlyContinue }
}

macOS / Linux

# Liberar puertos del Inspector (macOS / Linux)
lsof -ti :6274,:6277 | xargs kill -9 2>/dev/null || true

Conectores disponibles

Tres servidores MCP, un Inspector

🟣

Conector Holded → Claude

apps/holded-mcp · Vercel · OAuth 2.0 DCR

Transport: Streamable HTTP
URL: https://claude.verifactu.business/mcp
Autenticación: OAuth 2.0 — el Inspector abre automáticamente la pantalla de autorización.
Tools: 24 tools — 23 read-only + create_invoice_draft (draft-only)

1.Lanza el Inspector: npx @modelcontextprotocol/inspector@latest
2.Abre la URL con el token que imprime la consola.
3.Transport: Streamable HTTP · URL: https://claude.verifactu.business/mcp
4.Pulsa Connect → la página OAuth se abre en el navegador.
5.Introduce tu API key de Holded y pulsa Conectar.
6.Verás 24 tools con readOnlyHint y writeAnnotations.

Ver configuración completa

# Transport: Streamable HTTP
# URL: https://claude.verifactu.business/mcp
#
# → Connect → OAuth abre en el navegador
# → Introduce API key de Holded → Conectar
# → 24 tools listadas

Qué debes ver

tools/list devuelve exactamente 24 tools
readOnlyHint: true en los 23 tools de lectura
readOnlyHint: false solo en create_invoice_draft
create_invoice_draft responde con "approveDoc=false enforced"

Documentación completa

🟢

Conector Holded → ChatGPT

apps/app · Vercel · Bearer / OAuth

Transport: Streamable HTTP
URL: http://localhost:3000/api/mcp/holded
Autenticación: Bearer MCP_SHARED_SECRET (en apps/app/.env.local)
Tools: 70+ tools — preset holded_priority1 en modo shared_secret local

1.Copia HOLDED_TEST_API_KEY y MCP_SHARED_SECRET a apps/app/.env.local
2.Arranca: pnpm --dir apps/app dev
3.Transport: Streamable HTTP · URL: http://localhost:3000/api/mcp/holded
4.Añade header Authorization: Bearer <MCP_SHARED_SECRET>
5.Pulsa Connect.
6.tools/call usa HOLDED_TEST_API_KEY como fuente del tenant.

Ver configuración completa

# apps/app/.env.local
MCP_SHARED_SECRET=dev-inspector-secret
HOLDED_TEST_API_KEY=<tu_api_key_holded>

# Terminal 1
pnpm --dir apps/app dev

# Terminal 2 — Inspector UI
# Transport: Streamable HTTP
# URL: http://localhost:3000/api/mcp/holded
# Header: Authorization: Bearer dev-inspector-secret

Qué debes ver

tools/list (GET sin auth) devuelve el catálogo público
tools/call sin Bearer devuelve 401 + WWW-Authenticate
tools/call con Bearer funciona con HOLDED_TEST_API_KEY
El preset activo coincide con MCP_PUBLIC_SCOPE_PRESET

Documentación completa

🔵

Servidor Isaak MCP

apps/isaak + apps/app · isaak.verifactu.business

Transport: Streamable HTTP
URL: https://isaak.verifactu.business/api/mcp/isaak
Autenticación: Bearer isk_live_TU_API_KEY
Tools: 9 tools — facturas, VeriFactu, resumen fiscal, contexto empresa

1.Genera una API key en Isaak → Configuración → API keys.
2.Transport: Streamable HTTP · URL: https://isaak.verifactu.business/api/mcp/isaak
3.Añade header Authorization: Bearer isk_live_TU_API_KEY
4.Pulsa Connect.
5.tools/list muestra las 9 herramientas de Isaak.

Ver configuración completa

# Transport: Streamable HTTP
# URL: https://isaak.verifactu.business/api/mcp/isaak
# Header: Authorization: Bearer isk_live_TU_API_KEY
#
# → Connect → 9 tools listadas

Qué debes ver

tools/list devuelve 9 tools de Isaak
isaak_get_company_context responde con datos fiscales
isaak_list_invoices devuelve facturas paginadas
isaak_create_invoice_draft crea un borrador revisable

Documentación completa

Referencia de tools — Isaak MCP

9 tools del servidor Isaak

Accesibles desde cualquier agente compatible con MCP. Las tools marcadas W modifican datos y requieren confirmación explícita.

Tool	R/W	Descripción
`isaak_get_company_context`	R	Datos fiscales y configuración de la empresa activa
`isaak_list_invoices`	R	Lista facturas con filtros de fecha, estado y tipo
`isaak_get_invoice`	R	Detalle completo de una factura por ID o número
`isaak_create_invoice_draft`	W	Crea un borrador de factura (requiere confirmación)
`isaak_validate_verifactu_invoice`	R	Valida datos fiscales antes de emitir a AEAT
`isaak_issue_verifactu_invoice`	W	Emite la factura a AEAT (requiere token de confirmación)
`isaak_get_verifactu_status`	R	Estado del registro en AEAT para una factura
`isaak_get_fiscal_summary`	R	Resumen fiscal del periodo: ventas, gastos, resultado
`isaak_propose_action`	R	Propone la siguiente acción fiscal recomendada por Isaak

Para la referencia completa de las 24 tools del conector Holded → Claude, consulta holded.verifactu.business/conectores/claude/docs.

API Keys

Genera tu API key en segundos

Ve a Isaak → Configuración → API keys. Las keys isk_live_ acceden a datos reales. isk_test_ son para sandbox.

Ir a Isaak — generar key Docs API completa