Documentación

Agentes de IA (MCP)

Conectar el servidor MCP

Conecta Claude, Claude Code, ChatGPT, Cursor, VS Code o Codex a tu espacio de trabajo de AmICited mediante MCP. Una URL, inicio de sesión con OAuth y una clave de API como alternativa.

AmICited ejecuta un servidor MCP (Model Context Protocol) siempre activo. Una vez conectado tu cliente de IA, puede leer tus datos de visibilidad, ejecutar informes y, con acceso de escritura, añadir prompts, generar artículos o registrar anotaciones, todo desde una conversación normal. Cada función del dashboard también se ofrece como herramienta MCP, así que no hay nada que puedas hacer en la app que un agente no pueda.

Antes de empezar#

  • Un plan que incluya MCP. MCP está disponible en la prueba de 7 días y en Pro, Premium y Enterprise. Los espacios de trabajo Starter pueden ver la URL del servidor, pero las conexiones se rechazan hasta que se mejore el plan. Consulta planes y límites.
  • Permisos de Editor o superiores en el espacio de trabajo. La página MCP indica a los miembros que no los tienen que se lo pidan a un propietario o administrador del espacio de trabajo.
  • Un saldo de créditos positivo. Las lecturas por MCP son gratuitas, pero el endpoint comprueba que el espacio de trabajo tenga créditos antes de responder. Consulta créditos.

La URL del servidor#

Hay una única URL para todos:

text
https://api.flowhunt.io/mcp/amicited

El espacio de trabajo no está en la URL. Proviene de tu credencial: con OAuth eliges el espacio de trabajo en la pantalla de consentimiento, y una clave de API ya pertenece a un espacio de trabajo. También puedes copiar la URL desde la página MCP de la app, que la muestra con un botón Copy URL y las mismas instrucciones por cliente que aparecen más abajo. El transporte es HTTP en streaming.

Conecta tu cliente#

Elige tu cliente. Cada pestaña empieza con el inicio de sesión OAuth recomendado y termina con la alternativa de la clave de API.

Claude (web y Desktop)

Los conectores que añades en claude.ai también están disponibles en la app Claude Desktop.

  1. Abre los ajustes de conectores de Claude.
  2. Haz clic en + y después en Add custom connector.
  3. Pega https://api.flowhunt.io/mcp/amicited y haz clic en Add.
  4. Haz clic en Connect en el nuevo conector y aprueba el acceso en la ventana del navegador que se abre. Elige tu espacio de trabajo en la pantalla de consentimiento.

En un chat, abre el menú de herramientas y asegúrate de que el conector de AmICited esté activado.

Alternativa con clave de API (archivo de configuración de Claude Desktop). Añade esto bajo mcpServers en ~/Library/Application Support/Claude/claude_desktop_config.json en macOS y reinicia Claude Desktop:

claude_desktop_config.json
{
  "mcpServers": {
    "amicited": {
      "type": "http",
      "url": "https://api.flowhunt.io/mcp/amicited",
      "headers": {
        "Authorization": "Bearer <your-workspace-api-key>"
      }
    }
  }
}

Claude Code

Registra el servidor una vez desde tu terminal:

bash
claude mcp add --transport http amicited https://api.flowhunt.io/mcp/amicited

Después ejecuta /mcp dentro de Claude Code, elige Authenticate y aprueba el acceso en la ventana del navegador que se abre.

Alternativa con clave de API. Añade el servidor bajo la clave mcpServers de nivel superior en ~/.claude.json y reinicia Claude Code:

~/.claude.json
{
  "mcpServers": {
    "amicited": {
      "type": "http",
      "url": "https://api.flowhunt.io/mcp/amicited",
      "headers": {
        "Authorization": "Bearer <your-workspace-api-key>"
      }
    }
  }
}

ChatGPT

Los conectores MCP personalizados necesitan el Developer mode, disponible en los planes de pago de ChatGPT (Plus, Pro, Team, Enterprise). En los espacios de trabajo Business, Enterprise y Edu, puede que un administrador tenga que activarlo por ti.

  1. Activa el Developer mode como se describe en la documentación de conectores de OpenAI.
  2. En ChatGPT, abre Settings y después Apps & Connectors.
  3. Añade un conector personalizado y pega https://api.flowhunt.io/mcp/amicited.
  4. Aprueba el acceso en la ventana del navegador que se abre.

Alternativa con clave de API. En el paso 4, elige en su lugar la autenticación con clave de API y pega la clave de API de tu espacio de trabajo. Guarda el conector y después actívalo en un chat nuevo.

Cursor

En la página MCP de la app, selecciona Cursor y haz clic en Add to Cursor. Cursor instala el servidor y realiza el inicio de sesión por ti.

Si el botón no abre Cursor, añade el servidor a mano en los ajustes de Cursor bajo MCP, o edita ~/.cursor/mcp.json (o un .cursor/mcp.json por proyecto):

~/.cursor/mcp.json
{
  "mcpServers": {
    "amicited": {
      "url": "https://api.flowhunt.io/mcp/amicited"
    }
  }
}

Cursor abre un navegador para iniciar sesión la primera vez que se conecta. Pon el chat en modo Agent para usar las herramientas.

Alternativa con clave de API. Añade una cabecera a la misma entrada:

json
"headers": { "Authorization": "Bearer <your-workspace-api-key>" }

VS Code

VS Code usa el servidor a través de GitHub Copilot en modo Agent, así que Copilot debe estar activado.

En la página MCP de la app, selecciona VS Code y haz clic en Add to VS Code. VS Code instala el servidor y realiza el inicio de sesión por ti.

Para añadirlo a mano, abre la paleta de comandos, ejecuta MCP: Open User Configuration y añade el servidor bajo servers:

mcp.json
{
  "servers": {
    "amicited": {
      "type": "http",
      "url": "https://api.flowhunt.io/mcp/amicited"
    }
  }
}

Alternativa con clave de API. Añade "headers": { "Authorization": "Bearer <your-workspace-api-key>" } a la entrada. También puedes ejecutar MCP: Add Server…, elegir HTTP (HTTP or Server-Sent Events), pegar la URL y añadir la cabecera Authorization cuando se te pida.

Codex

Codex se conecta como un cliente MCP remoto estándar. Añade el servidor y después inicia sesión:

bash
codex mcp add amicited --url https://api.flowhunt.io/mcp/amicited
codex mcp login amicited

O edita directamente ~/.codex/config.toml:

~/.codex/config.toml
[mcp_servers.amicited]
url = "https://api.flowhunt.io/mcp/amicited"
oauth_resource = "https://api.flowhunt.io/mcp/amicited"

Alternativa con clave de API. Guarda la clave en una variable de entorno y apunta Codex a ella:

~/.codex/config.toml
[mcp_servers.amicited]
url = "https://api.flowhunt.io/mcp/amicited"
bearer_token_env_var = "AMICITED_API_KEY"

Codex ejecutado con ajustes de aprobación estrictos seguirá llegando a todas las herramientas de solo lectura a través de read_tool. Consulta toolsets y herramientas.

OAuth o clave de API#

OAuth 2.1 (recomendado)Clave de API del espacio de trabajo (alternativa)
ConfiguraciónPega la URL y aprueba en el navegadorPega la URL más una cabecera Authorization: Bearer
Espacio de trabajoSe elige en la pantalla de consentimientoFijado por la clave
Permisosamicited:read para conectar y leer; amicited:write también hace falta para escribirAcceso completo al espacio de trabajo
RevocaciónConnected clients → Revoke en la página MCPEliminar o hacer caducar la clave

OAuth es la mejor opción por defecto: no hay ningún secreto que pegar en un archivo de configuración, cada cliente aparece por su nombre en la página MCP bajo Connected clients, y puedes revocar uno sin tocar los demás. Un token OAuth de solo lectura puede listar y leer todo, pero cualquier herramienta que cree, edite o elimine se negará con un mensaje que nombra el ámbito amicited:write. Reintentar no ayudará; vuelve a conectar con acceso de escritura.

Trata una clave de API como una contraseña

Cualquiera que tenga una clave de API del espacio de trabajo puede ejecutar todas las herramientas del servidor sobre los datos de tu espacio de trabajo, incluidas las escrituras. Prefiere OAuth, mantén las claves fuera de repositorios compartidos y usa una variable de entorno cuando tu cliente lo permita.

Comprueba que funciona#

Pregunta algo pequeño a tu agente: “List my AmICited domains.” Debería llamar a list_domains y devolver tus dominios por nombre. Después prueba “Show my AI visibility for the last 30 days”, que usa prompt_analytics.

Si la conexión se rechaza, el mensaje suele indicar por qué:

  • Plan. “requires a Pro plan or above”: el plan del propietario del espacio de trabajo no incluye MCP.
  • Créditos. El saldo del espacio de trabajo es cero o negativo. Recarga y reintenta.
  • Límite de frecuencia. Las llamadas a herramientas tienen un tope por espacio de trabajo y hora: 120 en la prueba, 600 en Pro, 2.000 en Premium, ilimitadas en Enterprise. El mensaje indica cuándo se reinicia la ventana. Listar herramientas y leer skills no cuenta.

Relacionado#