Servidor MCP

¿Qué es el servidor MCP de SocialGO?

El servidor MCP de SocialGO expone el panel como un conjunto de herramientas para agentes de IA a través del Model Context Protocol. Una vez conectado, un asistente puede explorar el catálogo de servicios, crear y rastrear pedidos, solicitar recargas y gestionar el saldo, sin ningún código de integración a medida. Es una capa fina de lectura y acción sobre la misma API que usa tu panel, por lo que los agentes se mantienen dentro de los límites y los precios de tu cuenta.

Funciona con cualquier cliente compatible con MCP, incluidos Claude Desktop, Claude Code, Cursor y tus propios agentes creados sobre un SDK de MCP.

Añádelo a tu cliente

El servidor se distribuye como el paquete @socialgo/mcp y se ejecuta por stdio mediante npx, así que no hay nada que instalar ni alojar por tu cuenta. Añade la siguiente entrada a la configuración de tu cliente MCP:

{
  "mcpServers": {
    "socialgo": {
      "command": "npx",
      "args": ["-y", "@socialgo/mcp"],
      "env": {
        "SOCIALGO_API_KEY": "your_api_key_here"
      }
    }
  }
}

Con Claude Code puedes registrarlo con un solo comando desde tu terminal:

claude mcp add socialgo -- npx @socialgo/mcp

Después de añadirlo, recuerda definir SOCIALGO_API_KEY en el entorno para que el comando anterior pueda tomarla.

Autenticación

El servidor lee una única variable de entorno, SOCIALGO_API_KEY. Genera una clave desde la configuración de tu cuenta, mantenla en secreto y nunca la confirmes en el control de versiones. Cada llamada a una herramienta se autentica y autoriza con esta clave, y los pedidos se cobran del saldo de la cuenta correspondiente. Rota la clave desde tu panel en cualquier momento para revocar el acceso.

Herramientas principales

El servidor mantiene una superficie de herramientas pequeña y estable que cubre todo el ciclo de vida del pedido:

• search_services — Encuentra servicios por plataforma, tipo o palabra clave: el punto de partida de todo flujo de trabajo.
• get_service — Obtén los detalles completos de un servicio: tarifa, cantidad mín./máx. y opciones admitidas.
• create_order — Crea un pedido para un servicio contra un enlace o nombre de usuario de destino.
• order_status — Consulta el estado en vivo, el progreso y la cantidad restante de un pedido.
• balance — Consulta el saldo actual de la cuenta y la moneda.
• refill — Solicita una recarga para un pedido elegible que cayó por debajo de la cantidad entregada.
• cancel — Cancela un pedido que aún se puede cancelar y recupera los fondos restantes.
• list_orders — Pagina por los pedidos recientes con su estado actual.
• add_funds — Crea una intención de recarga para añadir saldo a la cuenta.

El diseño "buscar y luego actuar"

Un panel SMM típico ofrece miles de servicios en docenas de plataformas. Registrar una herramienta por servicio saturaría la lista de herramientas del agente, dispararía el tamaño de la ventana de contexto y haría que el modelo fuera más lento y menos preciso. SocialGO evita esto por completo.

En su lugar, el catálogo vive detrás de una única herramienta de descubrimiento. El agente primero llama a search_services para reducir miles de opciones a unas pocas coincidencias relevantes, inspecciona una con get_service y solo entonces actúa con create_order. Las mismas nueve herramientas cubren todo el catálogo sin importar cuánto crezca: añadir nuevos servicios en el backend nunca cambia la superficie de herramientas que ve el agente.

Un flujo completo se ve así:

1. search_services({ query: "instagram followers" })
   → returns a short list of matching services with ids + rates

2. get_service({ id: "<id>" })
   → confirms rate, min/max and options before spending

3. create_order({ id: "<id>", link: "<target>", quantity: 1000 })
   → returns an order id

4. order_status({ id: "<order_id>" })
   → poll until completed

Esto mantiene la lista de herramientas reducida y predecible, permite que el catálogo escale a miles de servicios y le da al agente un paso fiable de confirmación antes de gastar en cada ocasión.