Servidor MCP

MCP es un estándar para que una herramienta de IA use servicios externos. Cada proyecto de Forja tiene su servidor MCP: el asistente que ya usás para programar puede leer y modificar los datos de tu proyecto.

Cómo se conecta

URL: https://api.getforja.site/v1/mcp/<ID_DEL_PROYECTO>. El ID y la URL completa están en la pestaña Conectar del proyecto.
Transporte: HTTP (Streamable HTTP).
Autenticación: una llave del proyecto en el encabezado Authorization: Bearer <llave>. Las llaves se crean en Staging y API keys. Mirá Llaves y permisos.

Qué puede hacer, según los permisos de la llave

La llave solo ve las herramientas que sus permisos habilitan:

Permiso	Herramientas
Leer datos	`list_tables`, `query_records`, `get_record`, `search_documents`
Escribir datos	`create_record`, `update_record`, `delete_record`
Cambiar estructura	`create_table`, `update_column_type`

Una herramienta nueva está denegada por defecto: ninguna llave puede usarla hasta que se decida qué permiso la habilita. Cambiar estructura puede hacer perder datos al convertir el tipo de una columna, por eso es un permiso aparte de escribir registros.

Ejemplos de configuración

Estos ejemplos siguen la documentación pública de cada herramienta al momento de escribir esta página, y esas herramientas cambian seguido. Lo que Forja espera es MCP sobre HTTP con el encabezado Authorization; si tu herramienta lo soporta, debería funcionar. Si una instrucción dejó de servir, avisanos por contacto. Todavía no probamos Forja con VS Code (Copilot).

Claude Code

Terminal

claude mcp add --transport http forja \
  https://api.getforja.site/v1/mcp/<ID_DEL_PROYECTO> \
  --header "Authorization: Bearer <TU_LLAVE>"

Cursor

En el archivo .cursor/mcp.json de tu proyecto, o en la configuración global de MCP de Cursor:

mcp.json

{
  "mcpServers": {
    "forja": {
      "url": "https://api.getforja.site/v1/mcp/<ID_DEL_PROYECTO>",
      "headers": { "Authorization": "Bearer <TU_LLAVE>" }
    }
  }
}

Claude Desktop

Claude Desktop se conecta a servidores remotos a través de conectores. Para usar una llave en un encabezado, una opción es el paquetemcp-remote, en el archivo claude_desktop_config.json:

claude_desktop_config.json

{
  "mcpServers": {
    "forja": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://api.getforja.site/v1/mcp/<ID_DEL_PROYECTO>",
        "--header",
        "Authorization: Bearer <TU_LLAVE>"
      ]
    }
  }
}

Qué no hace todavía

Cada URL es de un solo proyecto, que tiene que existir. Por MCP no se pueden crear proyectos.
Por MCP no se pueden crear ni editar funciones: eso se hace en el dashboard, con el asistente.
No hay un único servidor para toda tu cuenta ni conexión con un clic desde directorios de conectores.

Mirá la lista completa en Qué no hace todavía.

Información revisada el 2026-10-24.