Resolución N° 5.616/2024. Más información
Todos los agentes
Earendil

Pi + Afip SDK

Instalá las skills y conectá Afip SDK al agente de terminal de Pi.

TerminalSkills + MCP

Necesitás una cuenta y un proyecto de Afip SDK con la conexión a este cliente habilitada.

Empezá en pocos pasos

  1. Prepará Pi

    Seguí la instalación oficial y conectá el modelo que quieras usar.

    Instalar Pi ↗
  2. Instalá las skills

    Desde tu proyecto, con Node.js 22.20 o posterior, seleccioná Pi y las skills que necesites.

    Terminal
    npx skills add AfipSDK/skills
  3. Agregá y autorizá el servidor

    Pi guarda la conexión en tu configuración de usuario. Completá el inicio de sesión en el navegador y elegí el proyecto, los permisos y, para Factura SDK, el ambiente.

    Terminal
    pi mcp add afipsdk --url https://app.afipsdk.com/mcp --oauth-client-registration cimd
    pi mcp login afipsdk
    pi
  4. Comprobá el servidor

    Abrí /mcp y confirmá que Afip SDK figure conectado. Si hace falta volver a iniciar sesión, podés hacerlo desde ese menú.

    Dentro de Pi
    /mcp
  5. Probá la conexión

    Pedile que consulte project_current y confirme el proyecto conectado, sin modificar datos.

    Tu primera consulta
    Llamá a project_current con el MCP de Afip SDK y decime cuál es el proyecto conectado, qué producto usa y cuál es su plan. No modifiques datos ni infieras el ambiente a partir de esa respuesta. Si la herramienta no está disponible, decilo.

Tu acceso a Afip SDK

Documentación para desarrollar. Herramientas para trabajar con tu proyecto.

Instrucciones para tu agente

Compartile la guía completa para agentes: incluye instalación MCP por cliente, Factura SDK y Mis Comprobantes. Leerla no requiere conectar tu cuenta.

Herramientas MCP

El servidor https://app.afipsdk.com/mcp conecta el agente con las herramientas de Afip SDK. Las operaciones disponibles dependen del producto, el proyecto y los permisos de la conexión. Revisá cada acción antes de autorizar cambios.

Skills de Afip SDK

Las skills de Afip SDK reúnen instrucciones para facturación, certificados, consultas, PDFs y otras tareas. Seleccioná las skills que necesites para tu proyecto.

¿Qué querés construir?

Copiá un ejemplo y adaptalo a tu proyecto.

Integrar facturación con Factura SDK
Leé https://afipsdk.com/docs/facturasdk/ y ayudame a integrar Factura SDK en este proyecto. Revisá el stack y proponé la creación de facturas con manejo de estados, errores, idempotencia y webhooks. Empezá con el ambiente de desarrollo simulado, sin ARCA. No uses los web services directos para este ejemplo ni emitas en producción.
Descargar Mis Comprobantes de ARCA
Ayudame a integrar la automatización Mis Comprobantes de Afip SDK: https://afipsdk.com/docs/automations/mis-comprobantes/. Quiero descargar los comprobantes del mes pasado. Confirmá si son emitidos o recibidos, la CUIT y el rango exacto de fechas. Usá credenciales guardadas o guiame para configurarlas fuera del chat. Proponé el inicio de la automatización, la consulta de su estado y la descarga del resultado, con manejo de errores. Mostrame los parámetros y esperá mi confirmación antes de ejecutarla.
Consultar una factura de Factura SDK
Consultá la documentación de https://afipsdk.com/docs/facturasdk/ y ayudame a recuperar una factura existente de Factura SDK. Confirmá el proyecto, el ambiente y el identificador antes de consultar. Mostrame su estado y los datos que devuelve la API, sin emitir una nueva ni inventar datos fiscales.
Mostrar el PDF de una factura
Ayudame a mostrar el PDF de una factura emitida con Factura SDK. Seguí https://afipsdk.com/docs/facturasdk/ y usá el pdf_url devuelto por la factura cuando esté disponible. Contemplá el estado pendiente y los errores; no generes otra factura para obtener el PDF.

Para trabajar mejor

  • Las skills aportan instrucciones; la conexión MCP se configura por separado.
  • Si agregaste el servidor con una sesión abierta, usá /reload.

Preguntas frecuentes

¿Necesito MCP para programar con Afip SDK?

No. Podés desarrollar con la documentación y los SDKs. MCP sirve para que el agente use las herramientas del proyecto desde la conversación.

¿Qué necesito para conectar mi proyecto?

Una cuenta en Afip SDK y acceso al proyecto. Autorizás la conexión desde el navegador, sin pegar tokens en el chat. El acceso al agente se gestiona por separado con su proveedor.

¿Puedo usarlo para emitir facturas?

Las herramientas disponibles dependen del producto y de los permisos de tu conexión. Empezá en pruebas y confirmá los datos y el ambiente antes de emitir en producción.

Si algo no funciona

No puedo autorizar la conexión

Actualizá Pi y repetí el inicio de sesión desde /mcp. Si Afip SDK no reconoce el cliente, contactá a soporte. No uses la identidad de otro agente.

El servidor no aparece

Revisá ~/.pi/agent/mcp.json. Una entrada del mismo nombre en .pi/mcp.json puede reemplazarla dentro de un proyecto de confianza.