Esta guía te lleva de no tener clave a una conexión de Provedly funcionando en Claude Code. Da por hecho que ya tienes una cuenta de Provedly con al menos un sitio, y Claude Code instalado en una terminal. Todo se reduce a una clave, un comando y un prompt de prueba.
Si todavía no has leído la presentación general, el artículo del lanzamiento explica qué puede y qué no puede hacer el servidor MCP.
Paso 1: crea una clave de API de cuenta
En el panel de Provedly, abre Settings y luego API keys. Elige Create key, ponle un nombre que reconozcas después, como "Claude Code en mi portátil", y elige un nivel de acceso.
- Read only permite a Claude ver tu cuenta, sitios, widgets, barras y estadísticas.
- Read and write además le permite pausar y reactivar widgets, crear y editar barras y añadir registros.
Si es la primera vez que lo pruebas, empieza con Read only. Siempre puedes crear una segunda clave más adelante. La clave empieza por provedly_ y se muestra una sola vez, así que cópiala antes de cerrar el diálogo. Si la pierdes, revócala y crea una nueva; no hay forma de volver a mostrarla.
Paso 2: añade el servidor
En una terminal, ejecuta:
claude mcp add --transport http provedly https://provedly.app/mcp \
--header "Authorization: Bearer provedly_YOUR_KEY"
Sustituye provedly_YOUR_KEY por la clave que acabas de copiar. Las partes del comando:
| Parte | Qué hace |
|---|---|
--transport http |
El servidor de Provedly usa streamable HTTP |
provedly |
El nombre con el que Claude Code mostrará este servidor |
https://provedly.app/mcp |
La dirección del servidor |
--header "..." |
Envía tu clave con cada solicitud |
Claude Code guarda esto en su configuración de MCP. Trata esa configuración como tratarías un archivo .env: ahora contiene un secreto. Si añades el servidor a nivel de proyecto y haces commit de la configuración, la clave va con ella, así que para un repositorio compartido mantenlo a nivel de usuario o deja la clave fuera del control de versiones.
Paso 3: comprueba la conexión
Inicia Claude Code y ejecuta /mcp. Deberías ver provedly en la lista con estado conectado y las herramientas de Provedly debajo: get_account, list_sites, list_widgets, list_bars, get_stats, get_install_snippet y, con una clave de escritura, set_widget_status, set_bar_status, create_bar, update_bar y add_record.
Si el servidor muestra un error, las causas habituales son un error al escribir la clave, que falte el prefijo Bearer en la cabecera o una clave revocada. Las claves revocadas fallan de inmediato, que es lo que quieres.
Paso 4: un primer prompt
Pregunta algo que solo necesite acceso de lectura y cuya respuesta puedas comprobar en el panel:
¿En qué plan estoy y cuánto he usado de las impresiones de este mes?
Claude debería llamar a get_account y responder con tu plan, sus límites y el uso actual. Abre el panel y compara. Si las cifras coinciden, la conexión funciona.
Una segunda buena prueba son las estadísticas:
¿Cuántos pedidos asistieron mis widgets en los últimos 30 días?
Eso llama a get_stats e informa de los pedidos asistidos por la prueba y sus ingresos en el periodo. La definición de pedido asistido es la misma que en el panel, explicada en cómo medir los pedidos asistidos por la prueba social.
Paso 5: prueba un cambio, con cuidado
Con una clave de lectura y escritura, prueba algo fácil de deshacer:
Pausa la barra llamada "Free shipping" y dime qué cambió.
Normalmente Claude listará tus barras, encontrará la que coincide, llamará a set_bar_status e informará del nuevo estado. Claude Code te pide aprobar las llamadas a herramientas a menos que las hayas permitido, y vale la pena mantener ese paso de aprobación para todo lo que escriba. Lee la llamada antes de aprobarla: nombra la barra y la acción.
Reactívala de la misma forma. Si pides reactivar algo que te pondría por encima del límite de tu plan, la solicitud se rechaza y Claude te dirá por qué, el mismo rechazo que da el panel.
Mantenerlo ordenado
Algunos hábitos que ayudan cuando esto pasa a formar parte de tu rutina:
- Una clave por equipo o por herramienta, con un nombre claro, para que revocar una no rompa las demás.
- Claves de solo lectura donde solo quieras informes. Más sobre esto en claves de solo lectura frente a claves de escritura.
- Revoca las claves que ya no uses. La pantalla de API keys las lista todas.
Si le pides a Claude que cree una barra, espera que vuelva en pausa. Las barras nuevas creadas mediante la API o MCP siempre empiezan así para que puedas revisar primero el texto y las fechas; decirle a Claude que la active es el segundo paso.
Cuando quieras ir más allá, el recetario de prompts tiene ejemplos para cada herramienta.
Preguntas frecuentes
¿Puedo usar la misma clave en Claude Code y en un script?
Sí, una clave funciona tanto para el servidor MCP como para la API REST. Aun así, las claves separadas son más fáciles de gestionar, porque puedes revocar una sin tocar la otra.
¿Qué pasa si quito el servidor de Claude Code?
Claude Code deja de llamar a Provedly y no cambia nada en tu cuenta. La clave sigue siendo válida hasta que la revoques en Settings, así que revócala si ya no la necesitas.
¿Claude ve los datos personales de mis clientes?
Ve lo que devuelven las herramientas: datos de la cuenta, sitios, widgets, barras y estadísticas y, al añadir un registro, el registro que le pides que añada. Trata la sesión como cualquier otro lugar por el que pasan datos de tu negocio.
Las cuentas y las claves son gratis para empezar: regístrate aquí.