Conecta tu agente

Conecta el servidor MCP de datos públicos a tu agente: de solo lectura, OAuth, sin API key. Los agentes y skills de código abierto se encuentran en github.com/unifapi-agent/agents.

Para la mayoría de los clientes no necesitas tocar un archivo de configuración ni pegar un token. Añade el servidor (un prompt pegado o un conector web), luego ejecuta un agente o una skill e inicia sesión con OAuth cuando el agente necesite datos en vivo por primera vez.

Conecta tu agente

Elige la ruta para tu cliente. Cada una enlaza el servidor MCP alojado (https://mcp.unifapi.com) para datos en vivo; añade las skills del agente con npx skills add unifapi-agent/agents.

Pega un único prompt

Claude Code, Codex, Cursor, OpenClaw, Goose, Hermes: cualquier agente que gestione sus propios servidores MCP. Pégalo y se añade el servidor y se ejecuta el inicio de sesión de OAuth:

Install the UnifAPI MCP server for me, then confirm it connected. It's a remote
(streamable HTTP) MCP server at https://mcp.unifapi.com. UnifAPI uses OAuth — open
the browser sign-in when prompted. It's read-only public data, no API key to paste.

Conector web (Claude, ChatGPT, Perplexity, Grok)

Añade un conector personalizado apuntando a https://mcp.unifapi.com y autoriza mediante OAuth. ChatGPT requiere el Modo Desarrollador (Plus, Pro, Team, Enterprise):

Settings -> Connectors -> Advanced -> enable Developer Mode
Connectors -> Create
MCP server URL: https://mcp.unifapi.com
Authentication: OAuth

Codex

Codex enlaza MCP y skills por separado. Añade el servidor MCP en ~/.codex/config.toml:

[mcp_servers.unifapi]
url = "https://mcp.unifapi.com"

Luego inicia sesión y añade las skills:

codex mcp login unifapi
npx skills add unifapi-agent/agents

Hosts de plugins compatibles con Claude

Claude Code, Claude Desktop y OpenClaw pueden instalar las skills y el servidor MCP juntos de una sola vez:

/plugin marketplace add unifapi-agent/agents
/plugin install unifapi@unifapi

Ejecuta un agente o una skill después y completa el inicio de sesión de OAuth cuando se te solicite.

Cualquier otro cliente MCP

Añade las skills y luego apunta el cliente al servidor MCP alojado para datos en vivo:

npx skills add unifapi-agent/agents

MCP server URL: https://mcp.unifapi.com

Ejecútalo

Después de instalar, inicia un nuevo chat o hilo y pide un resultado de tarea. Las skills del agente descubren y llaman a operaciones de datos públicos mediante MCP según sea necesario:

Analyze these Twitter/X KOLs for an AI developer-tool campaign: @vercel, @shadcn, @rauchg.
Use UnifAPI public data and return price ranges, evidence, confidence, and follow-up questions.

OAuth se abre solo cuando el agente necesita por primera vez llamar a herramientas de UnifAPI o gastar créditos del espacio de trabajo, de modo que puedes explorar e iniciar una tarea antes de iniciar sesión. Consulta Skills para el modelo de flujo de trabajo.

Qué puede hacer tu agente

Conectar le da a un agente acceso a las operaciones de datos públicos en vivo detrás de UnifAPI. Es útil para trabajos como:

• análisis de KOL de Twitter/X y listas cortas de influencers
• descubrimiento de creadores en TikTok, YouTube, Instagram, Reddit y otras plataformas compatibles
• monitorización de competidores a partir de publicaciones, perfiles, comentarios y tendencias públicas
• investigación de mercado a partir de señales sociales públicas
• enriquecimiento de leads y empresas a partir de datos públicos de estilo LinkedIn

El agente debería normalmente devolver un brief, una tabla, una lista corta, un rango de precios o un plan de seguimiento, no volcados de API en bruto.

Herramientas expuestas mediante MCP

UnifAPI expone tres herramientas MCP. No registra una herramienta MCP separada para cada endpoint de la API.

Flujo típico de un agente:

Avanzado: URL del servidor MCP y bearer de API key

Las rutas anteriores cubren la mayoría de los clientes. Usa esta sección si cableas MCP a mano, construyes sobre el transporte MCP HTTP o conviertes la conexión en producto para un cliente que necesita configuración explícita.

UnifAPI expone su capa de datos públicos mediante un servidor MCP alojado:

https://mcp.unifapi.com

Configuración manual de MCP

Si tu cliente acepta una URL de conector en bruto en lugar del plugin, añade el servidor alojado directamente.

Conector personalizado de Claude / Claude Desktop:

Customize -> Connectors -> + -> Add custom connector
Name: UnifAPI
URL: https://mcp.unifapi.com
Connect -> complete OAuth

Para los planes Team y Enterprise, un Owner añade primero el conector desde Organization settings -> Connectors; los miembros lo conectan luego desde Customize -> Connectors. Para configuraciones más antiguas de Claude Desktop solo locales, mcp-remote puede puentear el servidor alojado a través de claude_desktop_config.json:

{
  "mcpServers": {
    "unifapi": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.unifapi.com"]
    }
  }
}

CLI de Claude Code:

claude mcp add \
  --transport http \
  unifapi \
  https://mcp.unifapi.com

CLI de Codex:

codex mcp add unifapi \
  --url https://mcp.unifapi.com

Servidor Streamable HTTP remoto de OpenClaw:

openclaw mcp add unifapi \
  --url https://mcp.unifapi.com \
  --transport streamable-http \
  --auth oauth

openclaw mcp login unifapi
openclaw mcp doctor unifapi --probe

Hermes ~/.hermes/config.yaml:

mcp_servers:
  unifapi:
    url: "https://mcp.unifapi.com"
    auth: oauth

hermes mcp login unifapi

Cursor .cursor/mcp.json:

{
  "mcpServers": {
    "unifapi": {
      "url": "https://mcp.unifapi.com"
    }
  }
}

VS Code .vscode/mcp.json:

{
  "servers": {
    "unifapi": {
      "type": "http",
      "url": "https://mcp.unifapi.com"
    }
  }
}

Otros clientes MCP: usa Streamable HTTP con la URL canónica del servidor:

{
  "mcpServers": {
    "unifapi": {
      "url": "https://mcp.unifapi.com"
    }
  }
}

Detalles de OAuth

El servidor MCP de UnifAPI es un recurso protegido por OAuth.

Los metadatos del recurso protegido le indican a un cliente compatible dónde autorizar y qué scope se necesita. El token OAuth incluye un claim de espacio de trabajo, de modo que las llamadas a herramientas gastan los mismos créditos del espacio de trabajo que las llamadas HTTP directas a la API. OAuth autoriza UnifAPI; no concede acceso a las cuentas de origen privadas de un usuario.

No añadas campos de scope personalizados a la configuración del cliente a menos que tu cliente MCP los admita explícitamente. Un cliente compatible debería descubrir los metadatos del recurso protegido y solicitar el scope requerido.

Alternativa con bearer de API key

Usa esto solo cuando un cliente no pueda completar OAuth o solicite explícitamente un bearer token/cabecera. Las rutas de OAuth anteriores no necesitan una API key.

1. Inicia sesión en el panel de UnifAPI.
2. Crea una API key.
3. Configura tu cliente MCP para enviarla como cabecera de autorización:

Authorization: Bearer YOUR_UNIFAPI_KEY

Ejemplo en JSON al estilo de Cursor:

{
  "mcpServers": {
    "unifapi": {
      "url": "https://mcp.unifapi.com",
      "headers": {
        "Authorization": "Bearer YOUR_UNIFAPI_KEY"
      }
    }
  }
}

UnifAPI también acepta las cabeceras X-API-Key y X-UnifAPI-Key para clientes que no pueden establecer Authorization, pero se prefiere Authorization: Bearer ....

Facturación y créditos

Las llamadas MCP usan el mismo modelo de facturación que las llamadas HTTP.

• Conectar el servidor MCP (y añadir las skills) es gratis.
• call_api gasta créditos del espacio de trabajo cuando llama a una operación de datos públicos.
• Los metadatos de facturación se devuelven en el resultado de la herramienta cuando la respuesta de la operación los incluye.
• Si un espacio de trabajo no tiene créditos restantes, las llamadas fallan con insufficient_credits.

Consulta Límites de tasa para los límites de solicitudes y Errores para el vocabulario público de errores.

Resolución de problemas

El cliente pide una API key

Usa la alternativa con bearer de API key de arriba. Esto suele significar que el cliente aún no admite el descubrimiento de recursos protegidos de OAuth.

OAuth tiene éxito pero las llamadas a herramientas fallan

Comprueba si el flujo OAuth solicitó el recurso y el scope de MCP:

• Recurso/audiencia: https://mcp.unifapi.com/
• Scope: unifapi:mcp

Si un cliente no envía el recurso/audiencia durante el intercambio de tokens, puede recibir un token que no puede ser verificado por el recurso protegido de MCP.

401 unauthorized

A la solicitud MCP le falta un token válido, el token OAuth es inválido para este recurso, o el token de la alternativa de API key fue revocado o se escribió mal.

insufficient_credits

El espacio de trabajo conectado al token OAuth o a la API key no tiene suficientes créditos. Recarga créditos en el panel y reintenta.

La lista de herramientas parece desactualizada

Reinicia o recarga el cliente MCP. Algunos clientes cachean las sesiones del servidor y las listas de herramientas.

Recursos relacionados