Finnegans para Claude Desktop

Extensión de Claude Desktop que conecta a Claude con Finnegans. Le pedís en castellano, con tus palabras, lo que necesitás ("¿qué órdenes de compra pendientes tiene este proveedor?", "pasame los clientes de Córdoba a Excel", "cambiá la provincia de este cliente") y Claude busca el endpoint correcto, lee los 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 única vez, 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 te pasa Juan Sbatella.

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

1. En Claude Desktop, el Owner entra a la configuración de la organización, sección de extensiones.

2. Sube el archivo finnegans.mcpb como extensión del equipo.

3. Cada líder la activa desde Configuración, Extensiones, y completa el formulario (ver más abajo).

Opción B: instalación individual

1. Hacé doble clic en finnegans.mcpb, o arrastralo a la ventana de Claude Desktop.

2. Se abre la pantalla de instalación: tocá Instalar y completá el formulario.

3. Activá la extensión. Probá escribiendo: "verificá la conexión con Finnegans".

La primera vez que arranca puede tardar un poco porque prepara su propio entorno 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 ni las compartas: son personales de la organización.

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

Related MCP server: sqlserver-mcp-colossal

Qué puede hacer: las 8 herramientas

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

Las lecturas y las escrituras son herramientas separadas a propósito, para que Claude 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 (exportar solo 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 de tocar Permitir.

Actualizar

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

• Si lo instaló el Owner para el equipo: el Owner sube el archivo nuevo y reemplaza al anterior.

• Si lo instalaste vos: abrí el archivo nuevo con doble clic y confirmá el reemplazo.

Las claves cargadas se conservan. Si Juan Sbatella te avisa que cambió el formulario, 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 de trabajo, 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, exportaciones y 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 de empaquetar. El .mcpb generado no se versiona.