> ## Documentation Index
> Fetch the complete documentation index at: https://developers.readyforcommerce.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Conectar una IA

> Trabaja con tu organización desde Claude, ChatGPT u otro asistente de IA mediante el servidor MCP de Ready for Commerce.

Ready for Commerce tiene un servidor MCP, el estándar abierto que usan los asistentes de IA para llamar a las
herramientas de otras aplicaciones. Su dirección:

```text theme={null}
https://app.readyforcommerce.com/api/mcp
```

Conectado a él, un asistente de IA como Claude, ChatGPT, Gemini, Cursor o VS Code lee y trabaja con los datos de tu
organización mediante las mismas operaciones de esta API, como tú, dentro de lo que le permites.

## Conecta tu IA

**1. Abre Conectar una IA**

En la aplicación, ve a **Ajustes › API y conexiones** y pulsa **Conectar una IA**. Elige tu IA:
la ventana agrega la dirección con un botón donde tu IA tiene uno, le da a Claude Code un
comando para pegar y, si no, muestra la dirección y dónde pegarla. Cualquier IA que acepte la
dirección de un servidor MCP puede conectarse, desde sus propios ajustes.

**2. Inicia sesión y elige lo que puede hacer**

Tu IA abre el inicio de sesión de Ready for Commerce y luego una página que pregunta con qué
organización trabaja, cuando perteneces a más de una, y qué puede hacer allí: **Solo lectura**,
elegida de entrada, **Acceso completo** o **Personalizado**.

**3. Permite el acceso**

Tu IA ya lista las herramientas de Ready for Commerce. Pregúntale, por ejemplo, cuántas
exportaciones corrieron esta semana.

**Tu IA actúa como tú.** Cada una de sus llamadas se revisa como tuya, en el momento: nunca hace más de lo que tu
propio rol en esa organización permite, ni siquiera con **Acceso completo**, y su conexión termina cuando dejas la
organización o restableces tu contraseña.

## Desconecta una IA

**Ajustes › API y conexiones › IAs conectadas** lista las conexiones de la organización. Cada persona desconecta las
suyas, y una persona con permiso para administrar las conexiones desconecta las de cualquiera. Una IA desconectada se
detiene de inmediato, hasta que alguien la vuelva a conectar.

## Las herramientas son la API

Cada herramienta es una operación de esta API, con las mismas revisiones, permisos y errores: `get_org` es
[Obtener la organización](https://developers.readyforcommerce.com/es/api-reference/core-get-org.md), y `start_export` es
[Iniciar una exportación](https://developers.readyforcommerce.com/es/api-reference/core-start-export.md). Algunas lecturas de un mismo registro comparten una
herramienta, que elige con un argumento `method`: `get_job` lee un trabajo, sus mensajes o el enlace a un archivo. Lo
que solo hace una persona en la aplicación nunca es una herramienta.

* **Una escritura acepta un `idempotency_key` opcional,** que se envía como el
  [`Idempotency-Key`](https://developers.readyforcommerce.com/es/rate-limits#repite-una-escritura-sin-riesgo) de su llamada, así que una IA que reintenta
  nunca hace una escritura dos veces.
* **Un error vuelve como resultado de la herramienta,** con su `code` y una frase que le dice a la IA qué hacer, como
  cuánto esperar o qué permiso le falta.

## Límites

* **Llamadas:** una conexión de IA hace 300 llamadas por minuto, lecturas y escrituras juntas, y
  60 llamadas masivas, dentro del presupuesto de su organización ([Límites de uso](https://developers.readyforcommerce.com/es/rate-limits.md)).
* **Páginas:** una herramienta que lista responde 25 filas, salvo que la IA pida más, hasta
  100, y `nextCursor` sigue desde ahí. Una respuesta demasiado larga para que una IA la lea se recorta a las
  filas que caben, con `truncated: true`.

## Ningún dato personal llega a una IA

Un campo que contiene datos personales nunca llega a una herramienta, y una exportación que inicia una IA deja fuera las
columnas que nombran a personas, como quién creó o cambió por última vez un registro.

## Llámalo desde un programa

Un programa también puede llamar al servidor MCP, con una [llave de API](https://developers.readyforcommerce.com/es/authentication.md) como token Bearer,
enviando los mensajes JSON-RPC de MCP. Este llama a `get_org`:

```bash curl theme={null}
curl https://app.readyforcommerce.com/api/mcp \
  --header "Authorization: Bearer $RFC_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Accept: application/json, text/event-stream" \
  --data '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "get_org", "arguments": {}}}'
```

```python Python theme={null}
import os

import requests

response = requests.post(
    "https://app.readyforcommerce.com/api/mcp",
    headers={
        "Authorization": f"Bearer {os.environ['RFC_API_KEY']}",
        "Accept": "application/json, text/event-stream",
    },
    json={
        "jsonrpc": "2.0",
        "id": 1,
        "method": "tools/call",
        "params": {"name": "get_org", "arguments": {}},
    },
)
print(response.text)
```

```php PHP theme={null}
<?php
$curl = curl_init('https://app.readyforcommerce.com/api/mcp');
curl_setopt_array($curl, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('RFC_API_KEY'),
        'Content-Type: application/json',
        'Accept: application/json, text/event-stream',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'jsonrpc' => '2.0',
        'id' => 1,
        'method' => 'tools/call',
        'params' => ['name' => 'get_org', 'arguments' => new stdClass()],
    ]),
    CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($curl);
```

```javascript JavaScript theme={null}
const response = await fetch('https://app.readyforcommerce.com/api/mcp', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.RFC_API_KEY}`,
    'Content-Type': 'application/json',
    Accept: 'application/json, text/event-stream',
  },
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: 1,
    method: 'tools/call',
    params: { name: 'get_org', arguments: {} },
  }),
});
console.log(await response.text());
```

La respuesta es JSON, o un evento enviado por el servidor (server-sent event) cuya línea `data:` lo contiene.
`"method": "tools/list"` lista las herramientas que tu llave puede usar. Una biblioteca cliente de MCP hace todo esto
por ti: dale la dirección y la cabecera `Authorization: Bearer <tu llave>`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.