Saltar al contenido
Empezar gratis
Índice de la documentación

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

  1. Abre Ajustes (Settings), luego Conectores (Connectors) y Añadir conector personalizado (Add custom connector).
  2. Ponle un nombre (por ejemplo «Weldra») y escribe la dirección del servidor: https://app.weldra.ai/mcp. Deja vacías las opciones avanzadas.
  3. 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.
  4. 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», con retry_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.