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

Codex + Afip SDK

Instalá Afip SDK en Codex CLI para programar y usar las herramientas de tu proyecto.

TerminalPlugin + 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á Codex CLI

    Instalá Codex, iniciá sesión y abrí una terminal en tu proyecto.

    Instalar Codex CLI ↗
  2. Instalá el plugin de Afip SDK

    Agregá el catálogo e instalá el plugin. Incluye las skills y el servidor MCP.

    Terminal
    codex plugin marketplace add AfipSDK/skills
    codex plugin add afipsdk@afipsdk
  3. Conectá tu proyecto

    Abrí una sesión nueva y autorizá el servidor incluido cuando Codex lo solicite. Iniciá sesión en Afip SDK y elegí el proyecto, los permisos y, para Factura SDK, el ambiente.

  4. 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. El plugin de esta guía incluye las skills y el servidor MCP.

¿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

  • El plugin incluye las skills y el servidor MCP. No agregues una segunda conexión al mismo endpoint.
  • Revisá el proyecto y el ambiente antes de autorizar operaciones.

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á el agente y repetí el inicio de sesión. Si Afip SDK no reconoce el cliente, contactá a soporte. No ingreses un Client ID ni un secreto de otro agente.