# Construye con IA (/docs/ai)

Tu asistente de código (Claude, ChatGPT, Cursor, Copilot…) escribe mejor una integración cuando lee la fuente correcta. Te la damos en el formato que entiende.

<Cards>
  <Card icon={<Bot />} title="Skill para agentes" href="#skill">
    Las reglas de una integración correcta, para instalar en tu agente.
  </Card>
  <Card icon={<Plug />} title="Servidor MCP" href="#mcp">
    Tu agente busca y lee esta documentación en vivo.
  </Card>
  <Card icon={<FileCode2 />} title="llms.txt" href="#llmstxt">
    Toda la documentación en texto, para cualquier modelo.
  </Card>
  <Card icon={<Sparkles />} title="Copiar para IA" href="#cada-página">
    Cada página en Markdown, a un clic.
  </Card>
</Cards>

## Skill [#skill]

Una Skill le enseña a tu agente cómo se integra Caibo Pay: descubrir con capabilities, idempotencia, montos como texto, firmas de webhooks, estados asíncronos y los pasos para cobrar y pagar.

<Tabs items={["Claude Code", "Otros agentes"]}>
<Tab value="Claude Code">

```bash
mkdir -p ~/.claude/skills/caibo-pay
curl -fsSL https://docs.caibopay.app/skills/caibo-pay/SKILL.md -o ~/.claude/skills/caibo-pay/SKILL.md
```

Para un solo proyecto, guárdala en `.claude/skills/caibo-pay/SKILL.md` dentro del repositorio. Tu agente la usa cuando trabajas con Caibo Pay.

</Tab>
<Tab value="Otros agentes">

Descarga [`SKILL.md`](/skills/caibo-pay/SKILL.md) y agrégala a las instrucciones de tu agente: `AGENTS.md`, las reglas de Cursor (`.cursor/rules`) o las instrucciones de Copilot.

</Tab>
</Tabs>

## MCP [#mcp]

El servidor MCP de esta documentación le da a tu agente herramientas para listar, buscar y leer cada guía y cada endpoint, siempre al día.

```txt
https://docs.caibopay.app/api/mcp
```

<Tabs items={["Claude Code", "Cursor", "Otros"]}>
<Tab value="Claude Code">

```bash
claude mcp add --transport http caibo-pay-docs https://docs.caibopay.app/api/mcp
```

</Tab>
<Tab value="Cursor">

```json title=".cursor/mcp.json"
{
  "mcpServers": {
    "caibo-pay-docs": { "url": "https://docs.caibopay.app/api/mcp" }
  }
}
```

</Tab>
<Tab value="Otros">

Cualquier cliente MCP con transporte HTTP (streamable HTTP): usa la URL de arriba.

</Tab>
</Tabs>

El servidor MCP solo lee la documentación: no tiene tus claves ni llama a la API por ti.

## llms.txt [#llmstxt]

| Archivo | Contiene |
| --- | --- |
| [`/llms.txt`](/llms.txt) | El índice: cada página con su descripción. |
| [`/llms-full.txt`](/llms-full.txt) | Toda la documentación en un solo texto. |
| [`/openapi.json`](/openapi.json) | El contrato OpenAPI completo, para generar clientes y para tu agente. |

## Cada página [#cada-página]

Arriba de cada página tienes **Copiar para IA** (la página en Markdown) y **Abrir con IA** (la abre en ChatGPT, Claude o Cursor con la pregunta lista). También puedes agregar `.md` a cualquier URL:

```txt
https://docs.caibopay.app/docs/collect-one-payment.md
```

<Callout title="Un buen prompt para empezar">
"Lee https://docs.caibopay.app/llms-full.txt. Integra Caibo Pay en mi backend para cobrar con PIX un monto exacto, con idempotencia, verificación de la firma de los webhooks y pruebas contra sandbox."
</Callout>