Usar con tu IA (MCP)

Qué es

Geor ofrece un servidor MCP con esta documentación. MCP (Model Context Protocol) es un estándar para que una IA consulte un servicio externo.

Una vez conectado, tu IA consulta sola lo que necesita mientras programa, sin que le pegues la documentación:

• qué rutas hay;

• qué pide cada una;

• qué responde;

• qué errores hay que tratar.

Puedes pedirle, por ejemplo: «hazme una tienda en React, estilo minimalista, con la API de Geor».

• Es público y gratuito: no pide clave ni cuenta.

• Solo sirve documentación: no da acceso a datos de ninguna empresa.

• Siempre está al día: sirve la misma documentación publicada que estás leyendo.

Dirección del MCP

https://blogapi.pruebasqa.xyz/api/mcp

Es la única dirección que hay que configurar en tu IA.

Conectarlo

Claude (web y escritorio)

1. Abre Ajustes → Conectores.

2. Pulsa Añadir conector personalizado.

3. Escribe un nombre, por ejemplo Geor, y pega la dirección del MCP.

4. En una conversación, activa el conector Geor desde el menú de herramientas.

Claude Code (terminal)

claude mcp add --transport http geor https://blogapi.pruebasqa.xyz/api/mcp

Compruébalo con claude mcp list. A partir de ahí, Claude Code lo usa en cualquier proyecto y puede escribir los archivos de la tienda directamente.

ChatGPT

1. Abre Ajustes → Conectores (en algunas versiones, Aplicaciones y conectores).

2. En la configuración avanzada, activa el modo desarrollador.

3. Pulsa Crear y pega la dirección del MCP. Autenticación: ninguna.

4. En una conversación, activa el conector Geor desde el menú +.

ChatGPT usa sobre todo las herramientas search y fetch, que el MCP de Geor ofrece con el formato que espera.

Cursor

En ~/.cursor/mcp.json (para todos tus proyectos) o en .cursor/mcp.json (solo para uno):

{
  "mcpServers": {
    "geor": { "url": "https://blogapi.pruebasqa.xyz/api/mcp" }
  }
}

VS Code

En .vscode/mcp.json del proyecto:

{
  "servers": {
    "geor": { "type": "http", "url": "https://blogapi.pruebasqa.xyz/api/mcp" }
  }
}

Qué ofrece

También ofrece el prompt crear-tienda, que recibe el framework y el estilo que quieres y guía a la IA paso a paso. En Claude aparece en el menú de prompts del conector.

Cómo pedirle las cosas

Menciona a Geor en la petición, para que la IA sepa que tiene que usar el conector:

• «Usa el MCP de Geor y hazme una tienda en Vue con Tailwind, colores tierra, para https://miempresa.ejemplo.com.»

• «Con el MCP de Geor, añade a mi tienda el cálculo de envío a domicilio antes de pagar.»

• «Según el MCP de Geor, ¿qué errores puede devolver POST carts/pay y cómo los trato?»

La IA te mostrará cada consulta que hace al MCP. La primera vez te pedirá permiso para usarlo.

Antes de empezar

• Ten a mano la dirección de la API de la empresa, https://<dominio-de-la-empresa>/api/v1/ecommerce. El MCP explica cómo usarla, pero la dirección es de cada empresa. Ver introducción.

• La tienda de la empresa tiene que estar publicada en el ERP. Si no, el catálogo y el carrito responden 404 STORE_NOT_FOUND.

• Revisa el código que genere la IA antes de publicarlo, sobre todo el manejo del token del cliente y del identificador del carrito. Ver autenticación.

Límites

Cada dirección IP puede hacer 120 peticiones por minuto al MCP. Una IA que construye una tienda hace muchas menos. Si se supera, el MCP responde 429 y la IA vuelve a intentarlo poco después.

Si algo sale mal