Extensión de Claude Desktop
La extensión de Claude Desktop empaqueta el binario de la versión con un manifiesto que lee Claude Desktop, así que el servidor se instala desde un único fichero y se configura con un formulario, sin editar JSON. Cada versión adjunta cuatro paquetes a su versión de GitHub. No se publica nada hasta la primera versión; consulta Instalación.
Requisitos
Sección titulada «Requisitos»Claude Desktop 0.10.0 o posterior, en macOS 13 o posterior, Windows o Linux.
Elige un paquete
Sección titulada «Elige un paquete»| Paquete | Lleva |
|---|---|
arcane-mcp-darwin.mcpb | El binario universal de macOS (Apple Silicon e Intel) |
arcane-mcp-windows.mcpb | El ejecutable de Windows x64; Windows en Arm lo ejecuta con emulación |
arcane-mcp-linux.mcpb | Los dos binarios de Linux y un lanzador que elige uno según uname -m (x86-64 o arm64) |
arcane-mcp.mcpb | Los tres, una sola descarga para cualquier sistema |
Un paquete por sistema declara solo su propio sistema, así que Claude Desktop lo rechaza en otro con un mensaje claro.
Instalar
Sección titulada «Instalar»- Descarga el paquete de tu sistema desde la última versión.
- Ábrelo con Claude Desktop: haz doble clic en el fichero o arrástralo a Settings → Extensions.
- Revisa lo que pide la extensión e instálala; después rellena los ajustes (abajo) y actívala.
Ajustes
Sección titulada «Ajustes»| Ajuste | Variable que define | Valor por defecto |
|---|---|---|
| Arcane URL (obligatorio) | ARCANE_URL | — |
| Arcane API key (obligatorio, un campo sensible que Claude Desktop trata como secreto) | ARCANE_API_KEY | — |
| Default environment ID | ARCANE_ENVIRONMENT_ID | 0 |
| Tool surface | ARCANE_MCP_TOOL_SURFACE | dynamic |
| Read-only mode | ARCANE_MCP_READ_ONLY | desactivado |
| Safe mode | ARCANE_MCP_SAFE_MODE | desactivado |
| Skip TLS verification | ARCANE_SKIP_TLS_VERIFY | desactivado |
| Log level | ARCANE_MCP_LOG_LEVEL | info |
| Icons | ARCANE_MCP_ICONS | activado |
Cada ajuste llega al servidor como su variable de entorno, y un campo vacío cuenta como no definido, así que el servidor usa el valor por defecto. Los ajustes que no ofrece el formulario (exclusiones, plazos, elicitación) mantienen sus valores por defecto; Configuración los describe todos. Los logs del servidor van al log MCP de Claude Desktop para la extensión.
Notas por plataforma
Sección titulada «Notas por plataforma»- Linux: el lanzador (
server/linux/launch.sh, ejecutado con/bin/sh) eligearcane-mcp-linux-amd64oarcane-mcp-linux-arm64segúnuname -m, restaura el bit de ejecución del binario si el host lo ha perdido y lo dice en el log MCP cuando el tipo de máquina no está soportado o el directorio de la extensión está montado connoexec. - Windows en Arm: el paquete lleva el ejecutable x64, que Windows ejecuta con emulación. Para un binario arm64 nativo, usa winget o el binario publicado con una entrada manual.
Fijar una versión
Sección titulada «Fijar una versión»Cada paquete es la versión de la publicación a la que va adjunto: guarda el fichero de la versión que quieras, o descárgalo de la página de esa versión (https://github.com/jmrplens/arcane-mcp/releases/tag/vX.Y.Z).
Verificarlo
Sección titulada «Verificarlo»Los paquetes se construyen después de firmar checksums.txt, así que no están en él; cada uno tiene su propia atestación de procedencia de compilación (gh attestation verify arcane-mcp-darwin.mcpb --repo jmrplens/arcane-mcp), y la entrada del MCP Registry fija los tres paquetes por sistema con su SHA-256. Consulta Verificar una versión.
Actualizar y desinstalar
Sección titulada «Actualizar y desinstalar»La extensión nunca se actualiza sola. Para actualizarla, instala del mismo modo el paquete de la versión nueva; Claude Desktop sustituye la versión instalada. Para quitarla, abre Settings → Extensions, elige la extensión y desinstálala.