Conectar Wendo mediante MCP

Model Context Protocol (MCP) es un estándar para que un cliente de IA descubra y utilice herramientas publicadas por un servicio. En Wendo permite conectar una tienda con Codex, Claude, Cursor y otros clientes compatibles con servidores remotos y OAuth.

Cada conexión queda asociada a una única tienda. El servidor vuelve a comprobar el contexto, los permisos y las políticas aplicables cada vez que se utiliza una herramienta.

MCP y API REST

Superficie	Uso recomendado
MCP	Permite que un cliente compatible descubra herramientas y las use dentro de una conversación autorizada. La conexión se autentica mediante OAuth.
API REST	Permite construir integraciones HTTP directas contra operaciones documentadas en OpenAPI. Usa API keys de tienda.

MCP no reemplaza la referencia de la API REST ni comparte sus API keys. Los scopes, perfiles, herramientas, schemas y anotaciones MCP provienen exclusivamente del catálogo público vivo.

Disponibilidad efectiva

Que una herramienta aparezca en el catálogo no garantiza que esté disponible para una conexión concreta. La disponibilidad efectiva depende de:

los scopes autorizados durante OAuth;
los permisos actuales del usuario;
el plan de la tienda;
el estado de la suscripción; y
las políticas de seguridad de cada herramienta.

Catálogo público en vivo

Servidor MCP remoto

· · Carga:

Ver catálogo JSON

Cómo conectar un cliente

Agregá el servidor MCP remoto a un cliente compatible.
El cliente iniciará la autorización OAuth.
Iniciá sesión en Wendo.
Revisá la tienda, el cliente y los permisos solicitados.
Autorizá únicamente los scopes necesarios.
Regresá al cliente para usar las herramientas autorizadas.

URL obtenida de service.server_url

Guías por cliente

Fuentes oficiales verificadas el 15 de agosto de 2026.

Codex

Agregá un servidor Streamable HTTP en config.toml y luego iniciá OAuth desde la CLI.

Documentación oficial

Claude

Claude Code recomienda transporte HTTP para servidores remotos. El comando usa la URL publicada y /mcp abre la autenticación OAuth.

Documentación oficial

Cursor

Cursor admite Streamable HTTP remoto y OAuth. Podés instalarlo desde Customize o declarar un servidor remoto en mcp.json.

Documentación oficial

Cliente MCP compatible

Usá un cliente que admita Remote/Streamable HTTP y OAuth. Los nombres de controles y el formato de configuración dependen del cliente.

Guía oficial MCP

OAuth, acceso y aislamiento

Scopes disponibles

El título, descripción y tipo efectivo se derivan del catálogo vivo y de las herramientas que usan cada scope.

Perfiles recomendados

Son configuraciones sugeridas, no aprobaciones automáticas. Revisá siempre los scopes antes de autorizar.

Esta referencia necesita JavaScript para consultar el catálogo en tiempo real. Podés abrir el catálogo JSON público directamente.

Recomendaciones para autorizar

No es necesario copiar manualmente access tokens.
Aplicá mínimo privilegio y aprobá solamente los scopes necesarios.
No compartas tokens, códigos OAuth ni capturas que contengan credenciales.
Revisá la tienda y el cliente antes de confirmar la autorización.
Para ampliar permisos puede ser necesario volver a autorizar la conexión.

Seguridad de las herramientas

Las anotaciones del catálogo ayudan a evaluar cada herramienta, pero no reemplazan la revisión del efecto concreto:

Lectura: consulta datos sin declarar una modificación intencional.
Escritura: puede guardar o cambiar información y requiere permisos de escritura.
Destructiva: puede eliminar, reemplazar o producir un efecto difícil de revertir.
Idempotente: permite repetir la misma operación lógica sin duplicar su efecto cuando se usa correctamente. Esto no significa que sea inocua ni no destructiva.
Acceso externo u open world: puede consultar o afectar servicios fuera del límite directo de Wendo.

Según la operación, el servidor puede exigir confirmación explícita, una versión actual del recurso, una clave de idempotencia o pasos separados entre vista previa, borrador y publicación. Una vista previa no debe interpretarse como un cambio guardado; un borrador no equivale a contenido publicado.

Wendo conserva el aislamiento entre tiendas y aplica permisos, auditoría, plan y suscripción en el servidor. El cliente no puede ampliar esos límites enviando IDs o argumentos diferentes.

Consultá la referencia dinámica de herramientas para revisar el tipo, los scopes, los schemas y todas las anotaciones publicadas antes de autorizar una acción sensible.

Administrar una conexión

El seller puede abrir Conectores de IA en el administrador para:

revisar clientes o conexiones autorizadas;
consultar los permisos concedidos y la actividad;
reducir permisos; y
revocar una conexión.

Reducir permisos no permite ampliarlos nuevamente sin una nueva autorización. Después de revocar una conexión, hay que volver a autorizarla para recuperarla.

Troubleshooting

Problema	Qué revisar
OAuth no se abre	Confirmá que el cliente soporte servidores MCP remotos con OAuth y que use la URL exacta publicada arriba.
El cliente no acepta la URL	Verificá compatibilidad con Remote/Streamable HTTP; no reemplaces la URL ni agregues rutas inventadas.
Aparece `insufficient permissions`	Revisá scopes autorizados, permisos actuales del seller, plan y suscripción.
Una herramienta no aparece	Actualizá el catálogo, revisá los filtros y confirmá que la conexión tenga los scopes necesarios.
La conexión fue revocada	Volvé a autorizarla desde el cliente. Un token o código anterior no restaura la conexión.
La tienda quedó limitada a lectura	Revisá permisos concedidos, permisos actuales del seller, plan, suscripción y estado de la conexión.
El catálogo no responde	Reintentá o usá el último catálogo válido marcado como desactualizado. La guía estática sigue disponible.
Necesitás cambiar o ampliar permisos	Revisá la conexión en el administrador; ampliar scopes puede requerir una nueva autorización OAuth.

Nunca envíes tokens ni códigos OAuth para diagnosticar un problema.