Finnegans para Claude Desktop

Extensión de Claude Desktop que conecta a Claude con Finnegans. Le pedís encastellano, con tus palabras, lo que necesitás ("¿qué órdenes de comprapendientes tiene este proveedor?", "pasame los clientes de Córdoba a Excel","cambiá la provincia de este cliente") y Claude busca el endpoint correcto, leelos datos, los consulta, los exporta y, cuando se lo pedís, hace el cambio.

Funciona solo en Windows. Las claves de acceso las carga cada persona una únicavez, al instalar, en un formulario que Claude Desktop guarda de forma segura.

Instalación

Necesitás Claude Desktop actualizado y el archivo finnegans.mcpb que tepasa Juan Sbatella.

Opción A: instalación para todo el equipo (la hace el Owner de la organización)

En Claude Desktop, el Owner entra a la configuración de la organización,sección de extensiones.
Sube el archivo finnegans.mcpb como extensión del equipo.
Cada líder la activa desde Configuración, Extensiones, y completa elformulario (ver más abajo).

Opción B: instalación individual

Hacé doble clic en finnegans.mcpb, o arrastralo a la ventana de ClaudeDesktop.
Se abre la pantalla de instalación: tocá Instalar y completá elformulario.
Activá la extensión. Probá escribiendo: "verificá la conexión conFinnegans".

La primera vez que arranca puede tardar un poco porque prepara su propioentorno de Python. Después abre rápido.

El formulario, campo por campo

Todas las claves te las pasa Juan Sbatella. No las busques por tu cuenta nilas compartas: son personales de la organización.

Campo	Qué es	Obligatorio
Client ID de Finnegans	Identificador de la aplicación en Finnegans. Te lo pasa Juan Sbatella.	Sí
Client secret de Finnegans	Clave secreta de la aplicación. Se guarda enmascarada. Te la pasa Juan Sbatella.	Sí
Clave del swagger	Permite consultar el catálogo de endpoints. Se guarda enmascarada. Te la pasa Juan Sbatella.	Sí
Client ID de la documentación	Identificador para leer la documentación de la API. Te lo pasa Juan Sbatella.	Sí
Secret key de la documentación	Clave secreta de la documentación. Se guarda enmascarada. Te la pasa Juan Sbatella.	Sí
Carpeta de exportación	Donde se guardan los Excel y CSV que pidas. Por defecto, `Documentos\Finnegans`.	No
URL de la API, del swagger y de la documentación (avanzado)	Direcciones de Finnegans. Ya vienen cargadas: no las cambies salvo que Juan Sbatella te lo indique.	No

Si falta o está mal alguna clave, pedile a Claude "verificá la conexión conFinnegans": te dice cuál es la que falla.

Qué puede hacer: las 8 herramientas

Claude las elige solo según lo que le pedís.

Herramienta	Qué hace
`buscar_endpoint`	Busca qué endpoint de Finnegans sirve para tu pedido, en el swagger y en la documentación a la vez.
`ver_endpoint`	Muestra los métodos, parámetros y campos de un endpoint o recurso.
`leer`	Lee datos de Finnegans (GET); si son muchos, los carga en una tabla de trabajo.
`consultar`	Consulta con SQL de solo lectura las tablas ya cargadas, por páginas.
`exportar`	Guarda el resultado de una consulta como Excel o CSV en la carpeta de exportación.
`escribir`	Modifica datos en Finnegans (POST, PUT, PATCH o DELETE) y muestra qué cambió.
`guia`	Explica reglas del negocio: sucursales, IIBB, rutas, tipos de endpoint, escrituras, clientes y parámetros de reportes.
`verificar_conexion`	Comprueba las claves y la conexión, y dice cuál falla.

Las lecturas y las escrituras son herramientas separadas a propósito, para queClaude Desktop pueda pedirte permiso solo cuando se va a modificar algo.

Permisos recomendados en Claude Desktop

En Configuración, Extensiones, Finnegans, ajustá el permiso de cada herramienta:

Permitir siempre: buscar_endpoint, ver_endpoint, leer, consultar,exportar, guia y verificar_conexion. Son de solo lectura (exportarsolo escribe un archivo en tu carpeta de exportación).
Preguntar siempre: escribir. Es la única que cambia datos en Finnegans,y se ejecuta apenas la aprobás: leé bien lo que Claude va a mandar antes detocar Permitir.

Actualizar

Cuando haya una versión nueva, Juan Sbatella te pasa el finnegans.mcpbactualizado.

Si lo instaló el Owner para el equipo: el Owner sube el archivo nuevo yreemplaza al anterior.
Si lo instalaste vos: abrí el archivo nuevo con doble clic y confirmá elreemplazo.

Las claves cargadas se conservan. Si Juan Sbatella te avisa que cambió elformulario, Claude Desktop te va a pedir los campos nuevos.

Desarrollo

Requisitos: Python 3.12 o superior, uv y Node.js(solo para empaquetar).

uv sync                          # instala dependencias
uv run pytest                    # corre los tests
npx @anthropic-ai/mcpb pack . finnegans.mcpb   # genera el instalable

src/finnegans_core/: la lógica (cliente de Finnegans, catálogo, tablas detrabajo, exportación, guía de negocio).
src/finnegans_mcp/: el servidor MCP con las 8 herramientas.
manifest.json: la ficha de la extensión y su formulario de instalación.
.mcpbignore: lo que no viaja dentro del paquete (tests, docs, exportacionesy cualquier archivo local).

Los tests usan claves y respuestas falsas: no necesitan acceso a Finnegans.npx @anthropic-ai/mcpb validate manifest.json comprueba el manifest antes deempaquetar. El .mcpb generado no se versiona.

Finnegans para Claude Desktop