Conectar una IA

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:

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

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.

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.

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, y start_export es Iniciar una exportación. 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 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 llamadas por minuto, lecturas y escrituras juntas, y llamadas masivas, dentro del presupuesto de su organización (Límites de uso).
Páginas: una herramienta que lista responde filas, salvo que la IA pida más, hasta , 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 como token Bearer, enviando los mensajes JSON-RPC de MCP. Este llama a get_org:

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": {}}}'

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
$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);

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

Primeros pasos

Uso de la API

Asistentes de IA