# Configurá tu agente con Afip SDK

Instalá las skills, conectá el MCP y verificá el proyecto. Ejecutá los pasos que puedas completar desde este entorno; pedile al usuario sólo la autorización, los secretos por un canal seguro o las acciones de interfaz que no puedas realizar.

## 1. Elegí la instalación

Identificá el cliente y revisá su configuración existente. Conservá otros servidores y no dupliques una instalación de Afip SDK. ChatGPT web no es Codex; Claude web no es Claude Code.

### Agentes con plugin

Claude Code, Codex CLI, Cursor y VS Code pueden instalar el plugin con las skills y el MCP. Seguí la guía del cliente enlazada abajo y autorizá el servidor incluido. No instales las mismas skills por otra vía ni agregues una segunda conexión.

### Otros agentes de desarrollo

Si el cliente admite Agent Skills, instalalas desde tu proyecto con Node.js 22.20 o posterior:

```sh
npx skills add AfipSDK/skills
```

Seleccioná este agente y las skills que correspondan. Esta vía instala instrucciones, no configura MCP. Bionic usa su importador de skills desde GitHub: seguí su guía sin ejecutar el instalador. Los paquetes están en https://github.com/AfipSDK/skills.

### ChatGPT web y Claude web / Desktop

No ejecutes comandos locales: agregá Afip SDK desde apps/conectores y completá el consentimiento, si está disponible para la cuenta. Conectar MCP no importa las skills de este repositorio.

## 2. Conectá el MCP

Endpoint: `https://app.afipsdk.com/mcp`.

Leé y ejecutá **sólo la guía de este cliente**. Allí están la ubicación del archivo, la sintaxis y el método de autenticación; no copies configuraciones de otro agente:

- [Claude Code](https://afipsdk.com/docs/agent-setup/claude-code/)
- [Codex](https://afipsdk.com/docs/agent-setup/codex/)
- [Cursor](https://afipsdk.com/docs/agent-setup/cursor/)
- [ChatGPT web](https://afipsdk.com/docs/agent-setup/chatgpt/)
- [Claude web](https://afipsdk.com/docs/agent-setup/claude-web/)
- [GitHub Copilot](https://afipsdk.com/docs/agent-setup/github-copilot/)
- [Visual Studio Code](https://afipsdk.com/docs/agent-setup/vscode/)
- [OpenCode](https://afipsdk.com/docs/agent-setup/opencode/)
- [Pi](https://afipsdk.com/docs/agent-setup/pi/)
- [Vibe](https://afipsdk.com/docs/agent-setup/vibe/)
- [Devin](https://afipsdk.com/docs/agent-setup/devin/)
- [Command Code](https://afipsdk.com/docs/agent-setup/command-code/)
- [Droid](https://afipsdk.com/docs/agent-setup/droid/)
- [Grok Bot](https://afipsdk.com/docs/agent-setup/grok-bot/)
- [Bionic](https://afipsdk.com/docs/agent-setup/bionic/) — skills y documentación.

Si el plugin ya incluye el endpoint, autorizá ese servidor sin agregar otro. OAuth requiere que el cliente esté habilitado en Afip SDK. Para conexiones con token, seguí la configuración nativa de la guía. En Bionic, completá la instalación de skills y continuá con la documentación, sin los pasos de conexión MCP.

Usá el token del proyecto y ambiente correctos mediante el gestor de secretos, el entorno del proceso o el formulario del cliente. No pegues tokens ni contraseñas en el chat, comandos visibles, archivos versionados o logs. No desactives la autenticación para resolver un error.

## 3. Verificá la conexión

Para las guías con MCP, recargá o reiniciá el cliente si hace falta, comprobá el servidor y listá sus herramientas. Hacé esta consulta de sólo lectura:

> 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.

No emitas comprobantes ni ejecutes automatizaciones para probar la instalación. Si falla la autorización o faltan herramientas, informá el bloqueo; un archivo de configuración no prueba una conexión.

Al terminar, resumí: skills instaladas, configuración utilizada, estado de autorización, proyecto y producto verificados, y cualquier paso pendiente. No marques una conexión MCP como completa sin la consulta real. Si instalaste sólo skills, comprobá que el cliente pueda encontrarlas y dejá claro que no conectaste la cuenta.

## Para empezar a trabajar

- **Facturación electrónica:** usá [Factura SDK](https://afipsdk.com/docs/facturasdk/) y sus [primeros pasos](https://afipsdk.com/docs/facturasdk/getting-started/). Empezá en desarrollo simulado, sin ARCA; contemplá estados, idempotencia, errores y webhooks. No uses los web services directos para esta integración.
- **Mis Comprobantes:** seguí la [automatización](https://afipsdk.com/docs/automations/mis-comprobantes/) y la [integración API](https://afipsdk.com/docs/automations/integrations/api/). Confirmá CUIT, emitidos o recibidos y fechas; usá credenciales guardadas o el formulario seguro. Conservá el ID del trabajo y consultá su estado sin duplicarlo.

Antes de operar, confirmá alcance, producto, permisos y ambiente: Factura SDK y las automatizaciones son productos distintos. Las automatizaciones pueden operar sobre ARCA real. Leé los esquemas actuales de las herramientas antes de elegir parámetros.

Fuente: https://afipsdk.com/docs/agent-setup/prompt.md
