Usa koigrid desde ChatGPT, Claude o cualquier cliente MCP

koigrid tiene un servidor MCP remoto. Conéctalo una vez y tu asistente podrá desplegar apps, crear bases de datos, leer logs y consultar tu gasto, actuando como tú y sólo con los permisos que apruebes.

URL del servidor

Añade esta URL como conector personalizado (servidor MCP remoto) en tu asistente:

https://koigrid.com/mcp

Conectar

La primera vez, tu asistente abre una ventana de koigrid: entras (o creas una cuenta) y apruebas qué puede hacer y en qué organización. No hay que copiar ninguna clave. Tu asistente recibe un token de corta duración que se renueva solo.

Pruébalo

Una vez conectado, pídeselo a tu asistente con tus palabras. Por ejemplo:

  • “¿Qué tengo funcionando en koigrid?”

    list_resources: tus apps con su estado y URL, tus bases de datos y tus cachés.

  • “Despliega https://github.com/yo/mi-app como una app nueva llamada mi-app y avísame cuando esté en marcha.”

    deploy_app, y luego get_app_status hasta que el despliegue esté en marcha o falle.

  • “Mi último despliegue ha fallado. ¿Por qué?”

    get_app_status para ver el error, y después get_app_logs con el log de build.

  • “Crea una base de datos Postgres llamada mi-db y conéctala a mi-app.”

    create_database, get_database_connection y set_env_vars con una referencia: la contraseña nunca pasa por el chat.

  • “¿Cuánto he gastado este mes? Ponle un tope de 20 $ y avísame al 80 %.”

    get_spend y después set_spend_limit (tu asistente te pide confirmación).

O usa una clave de API

Los clientes que admiten una cabecera fija (Claude Code, Cursor y otros) pueden enviar un token de API de koigrid en vez de iniciar sesión:

claude mcp add --transport http koigrid https://koigrid.com/mcp --header "Authorization: Bearer koi_YOUR_KEY"

Qué puede hacer

Un conjunto pequeño de herramientas con forma de tarea, cada una con su propio permiso. Las de sólo lectura van marcadas para que tu asistente pueda usarlas sin preguntar.

  • list_resourcessólo lecturaapps:read

    Lists the apps (with status and public URL), databases and caches in the user's koigrid organization. Start here to find the id of an app or database before acting on it.

  • deploy_appapps:write · apps:deploy

    Deploys an app to koigrid. Pass appId to redeploy an existing app; or pass name plus a public Git repo URL (built automatically, Dockerfile or auto-detected) or a container image to create and deploy a new one. Pass env to deploy with its environment variables in the same deploy. Returns at once with the deployment id: the build runs in the background, so poll get_app_status until it is live or failed.

  • get_app_statussólo lecturaapps:read

    Shows an app's status, public URL and its latest deployments with their state and error. Use it to follow a deploy, and when something fails read the error here first.

  • get_app_logssólo lecturaapps:read

    Returns an app's logs: type "build" for the last deployment's build log (why a deploy failed), or "runtime" for what the running app prints (why it errors in production).

  • set_env_varspide confirmaciónapps:write

    Sets environment variables on an app and redeploys it. Values are stored encrypted. To wire a koigrid database without pasting its password, use a reference such as ${{db.<database-name>.DATABASE_URL}}.

  • rollback_apppide confirmaciónapps:deploy

    Puts a previous deployment of an app live again, without rebuilding. Pass the deploymentId from get_app_status; without it, rolls back to the previous live deployment.

  • create_databasedatabases:write

    Creates a managed Postgres database. Provisioning takes a few minutes: call get_database_connection afterwards to get the connection string once it is ready.

  • get_database_connectionsólo lecturadatabases:read

    Returns the connection details of a database (host, port, user, database) and the reference to wire it into an app with set_env_vars. The password is never returned: the reference is resolved by koigrid at deploy time.

  • get_migration_statussólo lecturadatabases:read

    For a database receiving a live migration (logical replication from an external Postgres): each subscription with its initial-copy progress (tables done of total), replication lag and a cutover verdict saying whether the app can be switched to koigrid yet, plus the remaining cutover steps. Never call the cutover done from lag alone: a subscription still copying tables can show zero lag.

  • get_spendsólo lecturausage:read · spend:read

    Shows what the organization has used and spent this month against its plan, and its spend limit if any.

  • set_spend_limitpide confirmaciónspend:write

    Sets a monthly spend limit for the organization, with optional alert thresholds and a hard stop that blocks creating new paid resources when it is reached.

Seguridad

Cada conexión aparece en Ajustes → API tokens como app conectada. Revocarla la desconecta al instante, incluido su token de refresco. Cada acción queda en tu registro de auditoría, y una conexión acotada a un proyecto no puede tocar recursos de otro. Los secretos nunca pasan por el chat: el asistente recibe el host y el usuario de tu base, pero no su contraseña, y la conecta a una app con una referencia que koigrid resuelve al desplegar.

Soporte

Dudas o problemas con el conector: [email protected] · Política de privacidad · Términos