Configuración de MCP

Endpoint

https://www.fuxux.com/api/mcp

Streamable HTTP sin estado: envía JSON-RPC con POST. No hay stream SSE, así que GET devuelve 405.

Autenticación

Hay dos formas de conectarse. Usa la que admita tu cliente.

Iniciar sesión (sin clave)

Añade el endpoint de arriba sin cabecera. El cliente abre Fuxux en tu navegador, inicias sesión, eliges Allow access y se conecta. No se pega nada en el chat.

• La app puede usar las herramientas de esta página y nada más. Nunca ve tu contraseña y no puede cambiar tu plan, la facturación ni las cuentas conectadas.
• Quita una app cuando quieras en Settings, en Connected apps. Deja de funcionar al instante.
• Para desarrolladores de clientes: autorización MCP estándar (OAuth 2.1 con PKCE). Los metadatos del servidor están en /.well-known/oauth-authorization-server; se admiten tanto Client ID Metadata Documents como el registro dinámico de clientes; los tokens de acceso duran una hora y se renuevan.

Clave de API

Envía tu clave en cada petición:

Authorization: Bearer fx_live_your_key_here

Los clientes que pueden poner una cabecera pero no añadir el prefijo Bearer pueden enviar x-api-key: fx_live_… en su lugar. Guarda las claves en variables de entorno o en el almacén de secretos de tu cliente, nunca en archivos de configuración compartidos.

Claude (web, escritorio y móvil)

1. En Claude, abre Settings, luego Connectors, y añade un conector personalizado.
2. Ponle de nombre Fuxux y pega el endpoint: https://www.fuxux.com/api/mcp
3. Elige Connect, inicia sesión en Fuxux si te lo pide y elige Allow access.

ChatGPT

Fuxux está en el directorio de plugins de ChatGPT. Abre el plugin de Fuxux (o busca Fuxux en Plugins), elige Install plugin, luego Connect Fuxux, inicia sesión y elige Allow access.

O añádelo a mano como servidor MCP personalizado (requiere un plan de pago de ChatGPT, en la web):

1. En ChatGPT, abre Plugins, elige Add y luego Create custom MCP server.
2. Ponle de nombre Fuxux, pega la URL del servidor https://www.fuxux.com/api/mcp y deja Authentication en OAuth.
3. Marca la casilla de confirmación, créalo, elige Continue to Fuxux, inicia sesión si te lo pide y elige Allow access.
4. Abre el plugin de Fuxux y elige Try in chat o menciona @Fuxux en un mensaje.

Claude Code

Para iniciar sesión, añade el servidor sin cabecera:

claude mcp add --transport http fuxux https://www.fuxux.com/api/mcp

Después ejecuta /mcp dentro de Claude Code, elige fuxux y autentícate en el navegador.

O, con una clave de API, añade el servidor desde tu terminal:

claude mcp add --transport http fuxux https://www.fuxux.com/api/mcp --header "Authorization: Bearer $FUXUX_API_KEY"

O compártelo con un proyecto en .mcp.json en la raíz del repositorio (Claude Code expande ${VAR} a partir de tu entorno):

{
  "mcpServers": {
    "fuxux": {
      "type": "http",
      "url": "https://www.fuxux.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${FUXUX_API_KEY}"
      }
    }
  }
}

Cursor (en un clic)

Define una variable de entorno con tu clave de API de Fuxux:

FUXUX_API_KEY=fx_live_your_key_here

Cursor expande ${env:NAME} en mcp.json (consulta la documentación de MCP de Cursor). Después añade el servidor:

O añádelo a mano en ~/.cursor/mcp.json o en el .cursor/mcp.json de un proyecto:

{
  "mcpServers": {
    "fuxux": {
      "url": "https://www.fuxux.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:FUXUX_API_KEY}"
      }
    }
  }
}

Claude Desktop y otros clientes solo stdio

Usa el puente mcp-remote (necesita Node.js) en claude_desktop_config.json. Poner la cabecera en env evita un problema conocido con los espacios en los argumentos en Windows:

{
  "mcpServers": {
    "fuxux": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://www.fuxux.com/api/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer fx_live_your_key_here"
      }
    }
  }
}

Manus y Cue

Añade Fuxux como conector Custom MCP con el endpoint de arriba y una cabecera Authorization. Los valores paso a paso y una nota de conector lista para usar están en la guía de Cue & Manus.

Herramientas

• whoami — comprueba que la conexión funciona y lee tu email y tu plan
• list_connected_accounts — tus cuentas sociales conectadas, con los ids que usan los targets de create_post
• get_dashboard — estadísticas, próximas publicaciones y cuentas que requieren atención
• list_posts — la cola: opcionales month, status (scheduled, published, draft, failed), limit (1–50, por defecto 20), offset y order (upcoming, newest, recently_published, recently_updated)
• create_post — publica al momento, programa con scheduled_at o guarda un borrador con draft: true. Pasa targets para elegir cuentas; si no, cada plataforma publica en su primera cuenta conectada. Reddit no es compatible.
• get_post — una publicación con sus variantes por plataforma (incluidos los borradores)
• update_post — reprograma, edita textos o reemplaza archivos de un borrador o de una publicación programada
• delete_post — elimina una publicación de Fuxux (no borra nada que ya esté publicado en la plataforma)

Ids de plataforma para captions y targets:

twitterinstagramlinkedinfacebooktiktokyoutubeblueskythreadspinterestdiscordkicktwitchtelegramslack

La facturación, la gestión de claves de API, los webhooks, los equipos y los ajustes de la cuenta no están disponibles como herramientas. Los equivalentes REST de las herramientas están en la referencia de la API.

Límites y buen comportamiento del agente

• 120 peticiones por minuto por clave y 300 por minuto por cuenta, sumando todas tus claves y apps con sesión iniciada. Si se supera el límite, las herramientas indican cuántos segundos esperar.
• No hagas polling. La publicación se resuelve en cuestión de minutos, así que comprueba el estado de una publicación con get_post como mucho una vez por minuto.
• Cuando una regla de la plataforma bloquea una publicación (por ejemplo, Instagram necesita una imagen o un vídeo), la herramienta devuelve el motivo como un error con el que el agente puede actuar.

Solución de problemas

• "Missing or invalid Authorization" / 401: la clave se revocó, se rotó o se escribió mal. Crea una nueva y revisa el prefijo Bearer y el espacio.
• 401 después de iniciar sesión: el acceso de la app caducó o se quitó en Settings. Vuelve a conectarla.
• 401 con una clave de API: la clave es incorrecta o está revocada, o tu cuenta no tiene un plan de pago. Revisa tu plan antes de crear una clave nueva. La regla del plan de pago se aplica a las claves de API, no al inicio de sesión.
• "Connect at least one account": ninguna de las plataformas de captions tiene una cuenta conectada. Cuando solo faltan algunas, esas se omiten: compara el resultado con las plataformas que enviaste.
• Límite de peticiones: espera los segundos que indica la herramienta y asegúrate de que el agente no compruebe el estado en bucle.