Instala SosoAPI: paquetes, clientes y MCP remoto

¿Qué paquete npm debo instalar?

Instala sosoapi para una configuración nueva. Los paquetes @sosoapi/cli, sosoapi-cli y sosoapi-mcp son alias que instalan la misma versión exacta de sosoapi. Ejecutan las mismas herramientas CLI y MCP, por lo que solo necesitas un paquete.

MCP local requiere Node.js 20 o posterior y npm/npx. MCP alojado no necesita paquete local. Tras instalar o conectar, inicia sesión para conceder acceso a tus cuentas.

• sosoapi
• @sosoapi/cli
• sosoapi-cli
• sosoapi-mcp

Conecta un cliente MCP local

Usa los comandos siguientes para añadir una conexión con perfil core. Si SosoAPI ya está conectado y funciona, conserva esa conexión. Ejecutar sosoapi sin argumentos inicia el servidor MCP stdio; espera al cliente en stdin.

Para Claude Desktop, Cursor u otro cliente stdio, añade el JSON siguiente en sus ajustes MCP. La ubicación de ajustes y los pasos de aprobación varían por cliente. Reinicia o vuelve a conectar si es necesario y comprueba que las herramientas SosoAPI estén disponibles en tu conversación.

claude mcp add sosoapi -e SOSOAPI_TOOL_PROFILE=core -- npx -y sosoapi

codex mcp add sosoapi --env SOSOAPI_TOOL_PROFILE=core -- npx -y sosoapi

{
  "mcpServers": {
    "sosoapi": {
      "command": "npx",
      "args": [
        "-y",
        "sosoapi"
      ],
      "env": {
        "SOSOAPI_TOOL_PROFILE": "core"
      }
    }
  }
}

• Referencia de herramientas MCP

Conecta MCP remoto con OAuth

En un cliente compatible con MCP remoto, OAuth y registro dinámico de clientes, añade la URL siguiente. Inicia sesión en el navegador y elige los espacios de trabajo y acciones que permites. No necesitas pegar una clave API, ID de cliente ni secreto de cliente. Para proporcionar archivos multimedia por HTTP, importa una URL pública; cargar archivos locales requiere el servidor MCP local.

Las aplicaciones personalizadas de ChatGPT y los conectores remotos de Claude dependen de tu plan y de los ajustes disponibles en ese cliente. Estas instrucciones configuran una conexión personalizada; no describen una entrada en un directorio de aplicaciones.

https://gqeshlawtcexsapabaui.supabase.co/functions/v1/remote-mcp

• Autenticación y permisos

Verifica la configuración sin publicar

Comprueba el estado de autenticación e inicia sesión si es necesario. Consulta el contexto del espacio de trabajo y las cuentas conectadas; confirma que la cuenta y el espacio devueltos sean los previstos. Esto verifica el acceso sin enviar una publicación; publicar sigue dependiendo de los permisos de esa cuenta.

No necesitas publicar una prueba para terminar la configuración. Continúa tu tarea original con su contenido existente. El usuario completa el consentimiento del proveedor y revisa el destino, el contenido y la hora antes de cualquier escritura solicitada.

npx sosoapi auth status

npx sosoapi api contract --route /identity-api/workspace/list --summary

Actualiza o fija una versión

Ejecuta npx -y sosoapi@latest --help para obtener la CLI actual y reinicia tu cliente MCP. Si el cliente tiene un comando guardado, incluye la versión deseada en sus args. Los alias siguen vinculados a su versión exacta de sosoapi; actualizar una instalación global independiente no los actualiza.

Si aparece un error de desajuste de versiones, compara el contrato instalado con la operación necesaria. Actualiza el paquete en el comando que realmente usa tu cliente MCP, vuelve a conectar y prueba de nuevo esa operación. Una incompatibilidad de esquema no requiere credenciales nuevas ni acceso más amplio.

npx -y sosoapi@latest --help

npx sosoapi api contract --summary

• Solución de problemas