Conectar Weldra a Claude
Servidor MCP remoto: https://app.weldra.ai/mcp
Qué es
Weldra conecta tiendas en línea y sistemas de empresa (como los ERP): mueve pedidos, productos, stock y clientes entre ellos con horarios y avisos entrantes, con mapeos, historial de ejecuciones y alertas. El conector de Weldra deja que Claude mire tu cuenta de Weldra y, si tú lo permites, la maneje: ver cómo van tus integraciones, averiguar por qué falló una ejecución, revisar elementos fallidos, lanzar o pausar una tarea, y editar proyectos, tareas y mapeos.
Claude actúa con tus permisos. Todo lo que hace queda en el registro de actividad de tu cuenta, y las credenciales nunca pasan por Claude: cuando hace falta un secreto (una conexión nueva, la dirección de un webhook), Claude te da el enlace a la pantalla que toca de la app de Weldra.
MCP («Model Context Protocol») es el modo estándar de enchufar un servicio a un asistente como Claude. Si todavía no conoces Weldra, empieza por Empezar con Weldra.
Requisitos
- Una cuenta de Weldra. Si no la tienes, escribe a hello@weldra.ai.
- Un plan de Claude que permita conectores personalizados (en los planes Team y Enterprise, primero lo añade una persona propietaria de tu organización de Claude).
- Las herramientas que ves dependen de tu rol en Weldra y de lo que permitas al conectar (mira la tabla de más abajo).
El conector se está abriendo a las cuentas por tandas. Si al conectar el servidor contesta «el servidor MCP aún no está disponible para esta cuenta» (un 403 con el código mcp_not_available), tu cuenta todavía no está habilitada: escribe a hello@weldra.ai.
Conectar en claude.ai, Claude Desktop y el móvil
- Abre Ajustes (Settings), luego Conectores (Connectors) y Añadir conector personalizado (Add custom connector).
- Ponle un nombre (por ejemplo «Weldra») y escribe la dirección del servidor:
https://app.weldra.ai/mcp. Deja vacías las opciones avanzadas. - Elige Conectar. Se abre una página de Weldra: entra con tu correo y el código que te enviamos, elige qué permites (leer, operar, editar) y pulsa Permitir.
- De vuelta en Claude, activa «Weldra» en el menú de herramientas de una conversación y pregunta, por ejemplo, «¿Cómo va mi cuenta de Weldra?».
El conector que añades en la web aparece también en Claude Desktop y en las apps del móvil con la misma cuenta de Claude. Los nombres de los menús los pone Anthropic y pueden cambiar.
Qué ves en la pantalla de consentimiento
El nombre de la aplicación que pide entrar y el sitio al que volverá, tu cuenta y tu rol, y los permisos que pide, cada uno con su casilla:
- Leer (
read): ver tus proyectos, tareas, runs, conexiones y alertas. - Operar (
operate): lanzar, pausar y reintentar runs. - Editar (
edit): crear y cambiar proyectos, tareas y mapeos.
«Permitir» solo da lo marcado y «Denegar» no crea nada. Lo que Claude puede hacer es tu rol más lo que has marcado, y se mira en cada llamada: si un owner te cambia el rol, vale en la llamada siguiente. El enlace de consentimiento vale 10 minutos y una sola vez: si caduca, vuelve a pulsar «Conectar» en Claude.
Conectar en Claude Code
claude mcp add --transport http weldra https://app.weldra.ai/mcp
Después, dentro de Claude Code, ejecuta /mcp, elige weldra y Authenticate: el navegador abre la página de consentimiento de Weldra. Es normal que al terminar el navegador vuelva a localhost: Claude Code recibe la respuesta en un puerto local de tu equipo. Para quitarlo:
claude mcp remove weldra
Alternativa: una clave API, para automatizar
Para scripts y uso sin nadie delante puedes autenticarte con una clave API en lugar de entrar con tu usuario. En la app de Weldra, una persona propietaria abre Organización, luego la pestaña API keys, y crea una clave: ponle una etiqueta y, si puede ser, una caducidad. La app propone una clave de solo lectura y su valor se muestra una sola vez. Se manda en la cabecera Authorization:
claude mcp add --transport http weldra https://app.weldra.ai/mcp --header "Authorization: Bearer $WELDRA_API_KEY"
Los clientes que no pueden poner esa cabecera pueden mandarla como X-API-Key. Nunca pongas una clave en la dirección ni en una cookie: si la pones ahí, no entra. Guarda el valor en una variable de entorno o en un gestor de contraseñas, no en un fichero del proyecto.
Con una clave, Claude puede lo que puede esa clave, y nunca lleva los permisos de administrar ni de facturación. Con el inicio de sesión, lo que puede tu rol y has concedido, y todo queda a tu nombre en el registro. Las dos formas funcionan a la vez y no se pisan.
Herramientas
Cada herramienta tiene un título y está marcada como de solo lectura o como de las que cambian datos, de modo que Claude te pide permiso antes de usar estas últimas. Además, las acciones más delicadas (cualquier cosa en producción, borrados, destinos nuevos para tus datos) necesitan un segundo paso explícito de confirmación en Weldra: la herramienta primero enseña qué cambiaría y no hace nada hasta que confirmas. Las tareas nuevas se crean apagadas. Solo ves las herramientas que permiten tu rol y tu consentimiento: 47 en total.
Según el tipo de clave (o los permisos que concedas con el inicio de sesión), Claude ve esto:
| Permisos | Qué puede hacer Claude |
|---|---|
Solo lectura (read) |
Mirar: cuenta, conexiones, proyectos, tareas, runs, incidencias y avisos. |
Lanzar y reprocesar (read y operate) |
Lo anterior, más lanzar tareas y grupos, reintentar incidencias y parar un run. |
Todo menos administrar (read, operate y edit) |
Lo anterior, más crear, cambiar y borrar proyectos, tareas, mapeos, conexiones y avisos. |
| Herramienta | Tipo | Quién la ve (permiso) |
|---|---|---|
check_connection |
Lectura | Cualquier miembro (Leer) |
export_project |
Lectura | Cualquier miembro (Leer) |
get_account_overview |
Lectura | Cualquier miembro (Leer) |
get_app_link |
Lectura | Con permiso de Editar (las acciones de administrar o cobrar piden además un owner con inicio de sesión) |
get_run |
Lectura | Cualquier miembro (Leer) |
get_task |
Lectura | Cualquier miembro (Leer) |
get_weldra_guide |
Lectura | Cualquier miembro (Leer) |
list_activity |
Lectura | Cualquier miembro (Leer) |
list_alerts |
Lectura | Cualquier miembro (Leer) |
list_connections |
Lectura | Cualquier miembro (Leer) |
list_connectors |
Lectura | Cualquier miembro (Leer) |
list_dead_letters |
Lectura | Cualquier miembro (Leer) |
list_groups |
Lectura | Cualquier miembro (Leer) |
list_mappings |
Lectura | Cualquier miembro (Leer) |
list_people |
Lectura | Cualquier miembro (Leer) |
list_projects |
Lectura | Cualquier miembro (Leer) |
list_recipes |
Lectura | Cualquier miembro (Leer) |
list_runs |
Lectura | Cualquier miembro (Leer) |
list_tasks |
Lectura | Cualquier miembro (Leer) |
list_webhook_activity |
Lectura | Cualquier miembro (Leer) |
list_webhook_subscriptions |
Lectura | Cualquier miembro (Leer) |
preview_mapping |
Lectura | Cualquier miembro (Leer) |
sample_connection |
Lectura | Cualquier miembro (Leer) |
search_ledger |
Lectura | Cualquier miembro (Leer) |
validate_task |
Lectura | Cualquier miembro (Leer) |
resolve_dead_letters |
Escritura | Cualquier miembro (Operar) |
retry_dead_letters |
Escritura | Cualquier miembro (Operar) |
rewind_task |
Escritura | Cualquier miembro (Operar) |
run_group |
Escritura | Cualquier miembro (Operar) |
run_task |
Escritura | Cualquier miembro (Operar) |
stop_run |
Escritura | Cualquier miembro (Operar) |
update_task |
Escritura | Cualquier miembro (Operar) |
create_mapping |
Escritura | Cualquier miembro (Editar) |
create_project |
Escritura | Cualquier miembro (Editar) |
create_task |
Escritura | Cualquier miembro (Editar) |
delete_connection |
Escritura | Cualquier miembro (Editar) |
delete_group |
Escritura | Cualquier miembro (Editar) |
delete_project |
Escritura | Cualquier miembro (Editar) |
delete_task |
Escritura | Cualquier miembro (Editar) |
import_project |
Escritura | Cualquier miembro (Editar) |
manage_connection_webhook |
Escritura | Cualquier miembro (Editar) |
manage_store_notices |
Escritura | Cualquier miembro (Editar) |
manage_trigger_url |
Escritura | Cualquier miembro (Editar) |
manage_webhook_subscription |
Escritura | Cualquier miembro (Editar) |
save_group |
Escritura | Cualquier miembro (Editar) |
update_connection |
Escritura | Cualquier miembro (Editar) |
update_project |
Escritura | Cualquier miembro (Editar) |
Las herramientas de administrar la cuenta y las de facturación no están en esta tabla y dependen de un interruptor del servidor que sube apagado: mientras esté apagado no salen en la lista de ninguna cuenta, tampoco para un owner. Cuando se enciendan, solo las verá un owner que conecta con inicio de sesión y las concede aparte. El cambio de plan y los datos de pago se hacen siempre en la app de Weldra.
Lo que Claude no hace
- Los secretos no pasan por Claude. Ni las credenciales de una conexión, ni la URL que lanza una tarea, ni el secreto de una suscripción de avisos: se escriben y se copian en la app. Claude te da el enlace a la pantalla (
get_app_link). - No lee direcciones que le des. Ninguna herramienta abre una URL que le pase el modelo.
- No hay una herramienta «hazlo todo». Cada una hace una cosa concreta con sus propios límites.
- Lo que viene de un sistema de fuera es dato, no instrucción. Una muestra de registros, un aviso que llega o el error de una tienda se entregan aparte y recortados, para que Claude los lea como datos.
Confirmaciones
La primera vez, la herramienta pide la acción sin confirmación. Si hace falta confirmar, no hace nada: te devuelve lo que cambiaría (el destino, el entorno, qué se borra) con un identificador de confirmación, y Claude tiene que enseñártelo y preguntarte. Solo si dices que sí, repite la llamada con ese identificador. La confirmación vale 10 minutos, una sola vez y solo para la acción exacta que te enseñaron; si entre medias cambia lo que hay que confirmar, sale otra confirmación nueva.
Prompts
El servidor ofrece tres prompts que solo dicen a Claude qué herramientas de lectura usar y en qué orden (en Claude Code salen como comandos, por ejemplo /mcp__weldra__diagnose_task): diagnose_task (por qué falla una tarea), weekly_summary (un resumen de los últimos 7 días) y plan_integration (planear una integración entre dos sistemas).
Límites
- Hasta 60 llamadas a herramientas por minuto y por credencial, de las que como mucho 20 pueden ser de escritura. Pasado eso, la herramienta contesta con un error (código
mcp_rate_limited) y los segundos que hay que esperar (retry_after). - Los resultados largos se recortan, y se le dice a Claude.
- Una confirmación vale 10 minutos, una sola vez y solo para la acción exacta que te enseñaron.
Ejemplos de peticiones
- «¿Cómo va mi cuenta de Weldra esta semana? Dame un resumen de ejecuciones y lo que esté pendiente.»
- «¿Por qué falló la última ejecución de la tarea 42? Mira sus elementos fallidos y el estado de sus conexiones.»
- «Lista los elementos fallidos de la sincronización de pedidos de ayer y dime qué tienen en común.»
- «Enciende la tarea 17.» Claude te enseñará qué supone encenderla y te pedirá confirmarlo.
- «Quiero sincronizar productos de mi tienda a mi ERP. ¿Qué tengo que preparar?»
Problemas frecuentes
- «El servidor MCP aún no está disponible para esta cuenta» al conectar (403, código
mcp_not_available): Tu cuenta no está habilitada para el conector. Escribe a hello@weldra.ai. - Claude no ve una herramienta que espero: Tu rol o los permisos que concediste no la incluyen. Desconecta y vuelve a conectar, y marca el permiso que necesitas en la página de consentimiento.
- Un error 401, o Claude me pide entrar otra vez: Se revocó el acceso, caducó la clave o ya no estás activo en la cuenta. Vuelve a conectar.
- Un error de ritmo con un número de segundos (estado 429, código
mcp_rate_limited, texto «too many tool calls for this credential in the last minute», conretry_after): Pasaste de 60 llamadas por minuto (20 de escritura). Espera esos segundos y reintenta. - La confirmación caducó o no vale: Pídele a Claude que empiece la acción otra vez; las confirmaciones duran 10 minutos y se usan una sola vez.
- Quiero quitarle el acceso a Claude: En la app de Weldra, en «Aplicaciones conectadas», pulsa «Revocar»: deja de valer en el acto. Quitar el conector solo en Claude no lo revoca de nuestro lado.
Privacidad
En resumen: guardamos las acciones que cambian tu cuenta (no el contenido de tus conversaciones), lo que devuelven las herramientas pasa a tu conversación con Anthropic, y nunca se devuelven secretos. Para cualquier duda sobre tus datos, escribe a hello@weldra.ai.
Soporte
hello@weldra.ai. Indica la hora del problema y, si la tienes, la etiqueta de la clave o de la aplicación que conectaste. No nos envíes nunca una clave ni un token.
Para integrar sin Claude, mira la API de Weldra.