Construir

Servidor MCP de Pickaxe

Conecta Claude Code, Codex, Cursor o VS Code directamente con tu espacio de trabajo: tus agentes, documentos y usuarios se convierten en herramientas que tu cliente de IA puede llamar.

Conecta Claude Code, Codex, Cursor, VS Code o cualquier otro cliente MCP directamente con tu workspace de Pickaxe. Tus agentes, documentos, usuarios y grupos de acceso se convierten en herramientas que tu cliente de IA puede usar — sin instalar nada en local y sin escribir código de integración.

Conectar un cliente MCP

¿Qué es el Servidor MCP de Pickaxe?

MCP (Model Context Protocol) es el estándar con el que los clientes de IA descubren y llaman herramientas externas. El Servidor MCP de Pickaxe pone todo tu workspace detrás de ese estándar: apuntas un cliente a la URL de tu workspace, te autenticas con una Workspace API Key y cada operación de la Workspace API de Pickaxe aparece como una herramienta que el cliente puede llamar.

Cada workspace tiene su propia dirección:

https://mcp.pickaxe.co/YOUR_WORKSPACE_ID

Es un servidor HTTP alojado, así que no hay nada que instalar ni que mantener en ejecución. Si tu cliente habla MCP sobre HTTP, puede comunicarse con Pickaxe.

Configuración

Entra a tu workspace, abre Settings y busca la sección Workspace API Keys. Debajo de la tabla de claves verás un panel llamado Connect an MCP client. Al desplegarlo encontrarás una configuración de dos pasos.

1. Elige tu conexión. Selecciona tu MCP client y la Workspace API key que quieres que use. Solo aparecen en la lista las claves con el interruptor Use activado — si el desplegable dice "No enabled API key", activa una (o pulsa Create para crear una nueva) antes de continuar.

Elegir un cliente MCP

Pickaxe formatea la configuración para cinco opciones:

Cliente	Dónde va la configuración
Codex	`~/.codex/config.toml`
Claude Code	Ejecuta el comando en tu terminal
Cursor	`~/.cursor/mcp.json`
VS Code	tu `mcp.json` de VS Code
Generic HTTP	cualquier otro cliente compatible MCP

2. Copia tu configuración. El panel escribe el fragmento completo por ti — URL del servidor, cabeceras y todo lo demás. Pulsa Copy setup y pégalo donde tu cliente lo espera.

Para Claude Code es un solo comando de terminal:

claude mcp add --transport http --scope user pickaxe "https://mcp.pickaxe.co/YOUR_WORKSPACE_ID" --header "Authorization: Bearer YOUR_WORKSPACE_API_KEY"

Para un cliente configurado con JSON como Cursor, se ve así:

{
  "mcpServers": {
    "pickaxe": {
      "url": "https://mcp.pickaxe.co/YOUR_WORKSPACE_ID",
      "headers": { "Authorization": "Bearer YOUR_WORKSPACE_API_KEY" }
    }
  }
}

Un detalle que conviene saber: tu clave está oculta en la vista previa en pantalla y solo se incluye cuando copias. Puedes compartir pantalla con el panel abierto sin riesgo; el portapapeles es otra historia.

¿Trabajas con varios workspaces? Agrega una entrada de servidor MCP por workspace, cada una con la URL y la clave de ese workspace.

Qué puede hacer tu cliente de IA

Una vez conectado, tu cliente puede ver y actuar sobre todo lo que cubre la Workspace API:

Agentes — listarlos, leer su configuración, crear nuevos, actualizar prompts y lanzar builds
Base de conocimiento — subir documentos, conectarlos y desconectarlos de agentes, actualizarlos o eliminarlos
Deployments — listar, actualizar y eliminar deployments, incluidas las sesiones del Meeting Bot y las conexiones de calendario
Usuarios — crear usuarios, consultarlos, actualizarlos o eliminarlos y revisar los seguimientos programados
Memoria — leer, escribir y borrar memorias del workspace y memorias por usuario
Grupos de acceso — crear grupos, asignar y quitar usuarios, previsualizar un borrado antes de confirmarlo
Portales y páginas — crear y rediseñar portales, gestionar páginas y enlaces de portal
Actions — listar las actions disponibles y sus ejecuciones, conectarlas y desconectarlas
Modelos y productos — listar los modelos disponibles en tu workspace y los productos configurados en él

Es la misma superficie con la que trabajan el Pickaxe CLI y Wingman — el Servidor MCP simplemente se la entrega directamente a tu propio cliente de IA.

Ejecutar un agente desde tu cliente MCP

Junto a las herramientas de la API hay una creada específicamente para esto: run_pickaxe_completion.

Le das el ID de un agente y un mensaje, y ejecuta ese agente y devuelve la respuesta. Lo interesante es lo que no necesita: el agente no requiere un deployment de API. Cualquier agente del workspace se puede ejecutar así, lo que facilita que tu agente de codificación pruebe un cambio de prompt, verifique una respuesta o encadene un agente de Pickaxe dentro de un flujo más grande sin desplegar nada antes.

Puedes pasar un mensaje, inputs estructurados, un ID de usuario, un ID de conversación, URLs de imágenes y metadata — con la misma forma que una petición de completion normal.

Cómo se limita el acceso

El Servidor MCP comprueba tres cosas en cada petición:

Que la clave sea una Workspace API Key válida. Los tokens de acceso OAuth no se aceptan aquí de forma deliberada.
Que la clave esté activada y pertenezca al workspace de la URL. Una clave de otro workspace se rechaza, y desactivar el interruptor Use de una clave corta la conexión de inmediato.
Que el objetivo pertenezca al workspace. Pedirle a run_pickaxe_completion que ejecute un agente de otro workspace falla.

Como la conexión está limitada a un solo workspace, un cliente de IA configurado para el proyecto de un cliente no puede alcanzar tus otros workspaces.

Una workspace API key es poderosa — puede crear, modificar y eliminar datos reales del workspace. Trátala como una contraseña: mantenla fuera de repos compartidos y capturas de pantalla, dale a cada herramienta su propia clave para poder revocar una sin romper el resto, y desactiva una clave en cuanto dejes de necesitarla.

¿Servidor MCP, CLI o Wingman?

Las tres opciones controlan el mismo workspace. Elige según dónde prefieras trabajar:

Servidor MCP — ya trabajas en Claude Code, Codex, Cursor o VS Code y quieres tener Pickaxe disponible como herramientas dentro de ese cliente, junto a todo lo demás que puede hacer.
Pickaxe CLI — quieres que un agente de codificación descargue tu workspace en local, trabaje sobre archivos y suba los cambios.
Wingman — prefieres no salir de Pickaxe. Es la misma potencia, a un clic dentro de tu workspace.

Muchos builders usan más de una. No entran en conflicto.

Más información

La lista completa de operaciones, cuerpos de petición y ejemplos está en la documentación de la API de Pickaxe — cada endpoint de ahí es una herramienta del Servidor MCP.

Pickaxe CLI

Pickaxe Wingman