Claude Code tiene un comando de una línea para añadir servidores MCP. La mayoría de los demás clientes usan una pantalla de ajustes o un archivo JSON. La información que introduces es la misma en todos, así que cuando conoces los tres valores que necesita Provedly, puedes conectarlo a la herramienta con la que trabajes.
Los tres valores
Todo cliente MCP que admite servidores remotos necesita lo mismo de ti:
- Transporte: HTTP. El servidor de Provedly usa streamable HTTP, así que elige la opción HTTP o "remote", no stdio.
- URL:
https://provedly.app/mcp - Cabecera:
Authorization: Bearer provedly_YOUR_KEY
La clave sale de Settings, luego API keys, en el panel de Provedly. Elige Read only o Read and write al crearla. Se muestra una sola vez, empieza por provedly_ y puedes revocarla cuando quieras. Si el cliente que usas no puede enviar una cabecera Authorization personalizada a un servidor remoto, todavía no puede conectarse a Provedly; en ese caso, la alternativa es la API REST.
Cursor
Cursor lee los servidores MCP de un archivo mcp.json, ya sea de forma global en tu directorio personal dentro de .cursor/ o por proyecto en la carpeta .cursor/ del proyecto. En el momento de escribir esto, un servidor remoto con cabecera se ve así:
{
"mcpServers": {
"provedly": {
"url": "https://provedly.app/mcp",
"headers": {
"Authorization": "Bearer provedly_YOUR_KEY"
}
}
}
}
Guarda el archivo y abre los ajustes de MCP de Cursor. La entrada provedly debería aparecer activada, con sus herramientas listadas. Si pones esto en un archivo a nivel de proyecto, comprueba si esa carpeta está en git. Una clave en un archivo con commit es una clave filtrada, y la solución es revocarla en Provedly y crear una nueva.
Los editores cambian sus pantallas de ajustes a menudo, así que si la disposición no coincide con esta descripción, busca la opción de servidor remoto o HTTP e introduce la misma URL y cabecera.
Otras herramientas compatibles con MCP
El patrón se repite en todos los clientes. Busca la forma de añadir un servidor remoto, HTTP o "streamable HTTP", ponle un nombre, pega la URL y añade una cabecera. Algunos clientes tienen un campo de cabecera en el formulario; otros aceptan un bloque JSON parecido al de Cursor. Sea cual sea la forma, el nombre de la cabecera es Authorization y el valor es Bearer seguido de tu clave, con un solo espacio.
Algunos clientes solo admiten servidores stdio locales. Esos no pueden llegar a Provedly directamente. Provedly no publica un wrapper local, así que para esas herramientas la vía de entrada es la API REST en https://provedly.app/api/v1, con la misma clave. El recorrido con curl cubre todos los endpoints.
Comprobar la conexión
Cuando el cliente muestre el servidor como conectado, haz una pregunta cuya respuesta puedas comprobar:
Lista mis sitios de Provedly y los widgets de cada uno.
El asistente debería llamar a list_sites y list_widgets y darte nombres que coincidan con el panel. Si creaste una clave de solo lectura, cualquier intento de pausar, crear o editar algo se rechazará. Es lo esperado, y pedir un cambio inofensivo es una buena forma de confirmar que la clave hace lo que crees.
Causas de fallo habituales, más o menos por orden de frecuencia:
| Síntoma | Causa habitual |
|---|---|
| El servidor muestra un error de autenticación | Falta el prefijo Bearer o hay un error en la clave |
| Funcionaba ayer, hoy falla | La clave se revocó en Settings |
| Herramientas listadas, escrituras rechazadas | La clave es Read only |
| Se rechaza una reactivación | Ese cambio superaría el límite de tu plan |
| El cliente no puede añadir el servidor | Solo admite servidores stdio locales |
Qué hacer con él
El cliente cambia, las herramientas no. Desde cualquier herramienta conectada puedes leer tu cuenta, sitios, widgets, barras y estadísticas, y con una clave de escritura puedes pausar o reactivar widgets, crear y actualizar barras y añadir registros. Algunos prompts que funcionan bien para empezar:
- "¿Qué widget tuvo más clics esta semana?"
- "Muéstrame todas las barras que están en marcha ahora, con su fecha de fin."
- "Dame el fragmento de instalación de mi tienda."
Para una lista más larga con lo que hace cada uno por detrás, consulta el recetario de prompts. Si estás en Claude Code y no en un editor, la guía de Claude Code tiene la versión de una línea.
Una nota sobre los equipos
Si varias personas de un equipo conectan sus editores, dale a cada una su propia clave. La pantalla de API keys lista cada clave con su nombre y nivel de acceso, así que cuando alguien se va, revocas su clave y nadie más se ve afectado. Compartir una clave en todo el equipo hace eso imposible sin romperlo para todos a la vez.
Preguntas frecuentes
¿El servidor MCP de Provedly funciona en claude.ai o ChatGPT?
La configuración compatible es Claude Code, Cursor y otras herramientas compatibles con MCP que puedan conectarse a un servidor HTTP remoto con una cabecera Authorization. No afirmamos que funcione con otros productos hasta haberlo desarrollado y probado.
¿Debo usar una configuración global o a nivel de proyecto en Cursor?
La global es más sencilla y mantiene la clave fuera de los repositorios. Usa el nivel de proyecto solo si necesitas claves distintas por proyecto y la carpeta no está en git.
¿Puedo conectar dos cuentas de Provedly?
Sí. Añade dos servidores con nombres distintos, cada uno con una clave de su propia cuenta. El asistente verá ambos conjuntos de herramientas y podrás decir a qué cuenta te refieres.
Puedes crear una clave en cualquier plan, Free incluido: empieza aquí.