Guía de instalación

Cuatro pasos para dejar las 8 skills funcionando en tu Claude.

Toma unos cinco minutos y se hace una sola vez. Todo pasa en el navegador: no se instala nada en tu equipo.

01 — Antes de empezar

Lo que necesitas a la mano

¿No encuentras tu clave? No se puede recuperar: se guarda cifrada y ni nosotros podemos verla. Escríbenos a hola@nexfiscal.mx desde el correo con el que contrataste y te emitimos una nueva el mismo día hábil.

02 — Instalación

Los cuatro pasos

  1. Agrega el marketplace de NexFiscal

    1. Entra a claude.ai con tu cuenta.
    2. Abre Ajustes → Customize → Plugins → Personal plugins.
    3. Haz clic en "+" y luego en Add marketplace.
    4. Elige Add from a repository y pega esta dirección:
    https://github.com/ernestosobrino/nexfiscal-skills

    Un marketplace es el catálogo desde donde Claude lee el plugin. Agregarlo todavía no instala nada.

  2. Instala el plugin nexfiscal

    Con el marketplace agregado ya aparece el plugin nexfiscal. Instálalo.

    Claude te va a mostrar un aviso de seguridad

    Dice que el plugin incluye un connector —un servidor MCP— externo. Es normal y esperado: ese servidor es el nuestro, el que entrega los valores fiscales vigentes y hace los cálculos.

    Para que lo tengas claro, esto es lo que el plugin no hace:

    • No ejecuta código en tu equipo: no trae scripts, binarios ni programas.
    • No accede a tus archivos, tu terminal ni tu sistema.
    • No instala nada fuera de Claude.

    Y esto es lo que sí hace:

    • Cuando pides un cálculo, envía a nuestro servidor solo los parámetros necesarios —montos, fechas, régimen, el RFC que quieres verificar contra las listas del SAT— y recibe el resultado con su fundamento legal.
    • No envía tus conversaciones.

    El repositorio es público y contiene únicamente archivos de texto y datos (.md, .json, .csv). Puedes revisarlo completo antes de instalar.

  3. Autoriza el connector con tu clave

    La primera vez que uses cualquiera de las skills, Claude te pedirá autorizar el connector NexFiscal. Se abre una pantalla nuestra que se ve así:

    mcp.nexfiscal.app

    NexFiscal Skills

    Claude solicita acceso a tu suscripción NexFiscal para calcular con valores fiscales vigentes.

    ••••••••••••••••••••
    Autorizar
    Así se ve la pantalla de autorización. El campo oculta lo que escribes.

    Pega ahí tu clave nxf_… y presiona Autorizar. No se pide correo ni contraseña: la clave sola te identifica.

    Si Claude no te pide la clave, el connector no quedó autorizado y las skills no estarán consultando nuestro servidor. Es la falla más fácil de pasar por alto, porque Claude puede seguir respondiendo —solo que sin los valores vigentes. Revisa el Caso 3 más abajo.

    Este paso se hace una sola vez. De ahí en adelante las skills funcionan solas.

  4. Pruébalo

    Abre una conversación nueva —las que ya tenías abiertas no ven un plugin instalado después— y pide algo concreto:

    Calcula la nómina de un empleado con sueldo de $18,000 en Jalisco.

    o

    Verifica si el RFC XAXX010101000 aparece en las listas 69 o 69-B del SAT.

    Si te responde con cifras, con su fundamento legal y con la fecha de corte del dato, ya quedó.

03 — Las skills

Qué le puedes pedir a cada una

No hay que "abrir" una skill: describes lo que necesitas en español y Claude elige la que corresponde.

SkillPara qué la vas a usar
Calculadora de Nómina MXNómina, finiquito, costo real del trabajador, consulta de UMA, tablas de ISR y cuotas IMSS vigentes e históricas
Actualización y RecargosActualización del Art. 17-A CFF, recargos por mora (SAT, IMSS, INFONAVIT), pago en parcialidades y diferido, saldos a favor
Régimen Fiscal ÓptimoComparar carga fiscal entre RESICO, Actividad Empresarial, arrendamiento, plataformas y persona moral
Dictaminador CFDIValidar facturas contra los catálogos del Anexo 20 y verificar RFCs en las listas 69, 69-B y 69-B Bis, con su fecha de corte
Gestor Laboral MXDocumentos y procesos laborales conforme a la LFT
Contratos MercantilesRedacción de contratos mercantiles mexicanos
Redactor de Actas de AsambleasActas y resoluciones societarias
Compliance LFPDPPPAvisos de privacidad y cumplimiento de datos personales, conforme a la ley de 2025
04 — Mantenimiento

Cómo se mantiene al día

Son dos cosas distintas, y solo una te pide hacer algo.

Las cifras se actualizan solas

La UMA, las tablas de ISR, las cuotas del IMSS, el INPC, las tasas de recargos y los cortes de las listas 69 y 69-B viven en nuestro servidor y se recargan del lado nuestro. Tú no descargas ni reinstalas nada: el siguiente cálculo ya sale con el valor nuevo.

Las skills nuevas sí piden un paso

Cuando publiquemos una versión nueva del plugin te avisamos por correo. Claude todavía no ofrece un botón de "actualizar", y —esto es lo que confunde— desinstalar el plugin y volver a instalarlo desde la misma pantalla deja la versión anterior. Lo que sí funciona es reinstalar el marketplace:

  1. Abre Plugins

    En claude.ai: Ajustes → Customize → Plugins.

  2. Elimina el marketplace de NexFiscal

    Ve a la lista de marketplaces y elimínalo. Este es el paso que importa: saltárselo es lo que deja la versión vieja.

  3. Agrégalo de nuevo

    Add marketplace → Add from a repository con la misma dirección:

    https://github.com/ernestosobrino/nexfiscal-skills
  4. Instala y abre una conversación nueva

    Instala el plugin nexfiscal y empieza una conversación nueva.

No pierdes la suscripción ni la clave: viven en nuestro servidor. A lo mucho Claude te pedirá autorizar el connector otra vez — pegas tu clave y listo.

05 — Si algo no sale como esperabas

Los casos que hemos visto

Caso 1 · El plugin no aparece después de agregar el marketplace

Recarga la página de claude.ai y vuelve a entrar a Plugins. Verifica también que tu plan de Claude sea de pago: en el plan gratuito la sección de plugins no habilita la instalación.

Caso 2 · Instalé el plugin pero Claude no usa las skills

Abre una conversación nueva. Las que ya estaban abiertas no ven un plugin instalado después.

Caso 3 · Nunca me pidió la clave

Entonces el connector no quedó autorizado, y las skills no están consultando nuestro servidor. Vale la pena revisarlo aunque Claude te esté respondiendo: sin el connector, las cifras no vienen de nuestros valores vigentes. Para comprobarlo, pide en una conversación nueva ¿Cuál es el estado de mi suscripción NexFiscal?. Si no te contesta con tu plan y tu vigencia, escríbenos y lo resolvemos contigo.

Caso 4 · Al autorizar aparece "Clave de suscriptor no válida"

Casi siempre es un espacio o un salto de línea que se pegó junto con la clave. Cópiala de nuevo desde el correo, sin espacios antes ni después, y confirma que empieza con nxf_.

Caso 5 · Aparece "Usa tu clave de suscriptor NexFiscal (nxf_…), no un token de acceso"

Se pegó otra cosa en el campo. La que sirve es la clave del correo de bienvenida, la que empieza con nxf_.

Caso 6 · Las skills avisan que la suscripción no está activa

Revisa el estado de tu suscripción en el portal —el enlace viene en tu correo de bienvenida— o escríbenos. Mientras no esté activa, las skills no entregan cifras: es a propósito. Preferimos no darte un número a darte uno que quizá ya no esté vigente.

Caso 7 · Un cálculo no coincide con tu criterio

Escríbenos con el caso concreto: los datos de entrada y el resultado que esperabas. Lo revisamos contra la disposición aplicable. Si hay que ajustar un valor o un criterio, se corrige en nuestro servidor y te llega de inmediato, sin que reinstales nada.

Caso 8 · ¿Qué versión de las skills tengo instalada?

En claude.ai, en Ajustes → Customize → Plugins, el plugin nexfiscal muestra su número de versión junto al nombre. Compáralo con el que anunciamos en el último correo de versión nueva. Si el tuyo es menor, reinstala el marketplace siguiendo el apartado "Las skills nuevas sí piden un paso" de más arriba — y ojo, es el marketplace, no solo el plugin.

Si nos escribes por cualquier otra cosa, mándanos ese número: con él sabemos de inmediato si lo que ves viene de una versión anterior.

06 — Tu clave

Cuídala como una contraseña

¿Se atoró algo? Escríbenos.

hola@nexfiscal.mx — respondemos el mismo día hábil. Si escribes por un cálculo, mándanos los datos de entrada y lo que esperabas: con eso lo reproducimos rápido.