Servidor MCP

Conectar

La URL del servidor es http://localhost:3000/api/mcp (Streamable HTTP). Las aplicaciones que permiten iniciar sesión (ChatGPT, Claude) se conectan sin clave; el resto usa una clave de API.

Con una clave de API (Claude Code, Cursor, VS Code, Claude Desktop): créala en Integraciones → API y automatizaciones y úsala en tu cliente:

claude mcp add --transport http huginnova http://localhost:3000/api/mcp \
  --header "Authorization: Bearer TU_CLAVE_DE_API"

{
  "mcpServers": {
    "huginnova": {
      "url": "http://localhost:3000/api/mcp",
      "headers": {
        "Authorization": "Bearer TU_CLAVE_DE_API"
      }
    }
  }
}

{
  "servers": {
    "huginnova": {
      "type": "http",
      "url": "http://localhost:3000/api/mcp",
      "headers": {
        "Authorization": "Bearer TU_CLAVE_DE_API"
      }
    }
  }
}

{
  "mcpServers": {
    "huginnova": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://localhost:3000/api/mcp",
        "--header",
        "Authorization:${AUTH}"
      ],
      "env": {
        "AUTH": "Bearer TU_CLAVE_DE_API"
      }
    }
  }
}

Autenticación

Dos formas, ambas como Authorization: Bearer …: una conexión OAuth (aplicaciones con inicio de sesión) o una clave de API. Las conexiones y claves de solo lectura pueden usar todas las herramientas de consulta; el acceso completo permite además las de cambios. El servidor MCP está incluido en todos los planes. Límite: 120 peticiones por minuto por conexión o clave.

OAuth, para desarrolladores

OAuth 2.1 tal como lo describe la especificación de autorización de MCP. Una petición sin token recibe un 401 cuya cabecera WWW-Authenticate apunta a los metadatos del recurso protegido; desde ahí, los metadatos del servidor de autorización en /.well-known/oauth-authorization-server. Las aplicaciones se identifican con un Client ID Metadata Document (un client_id https) o se registran con Dynamic Client Registration. Solo código de autorización con PKCE (S256), y el resource debe ser la URL del servidor MCP. Permisos: read y write (la persona puede conceder menos de lo pedido). Los tokens de acceso duran una hora; los de refresco rotan en cada uso, y reutilizar uno antiguo cierra la conexión.

Prompts

Preguntas listas que tu cliente muestra en su menú («/» en Claude), en el idioma de tu espacio de trabajo. Los nombres de marca y competidor se autocompletan al escribir; la marca es opcional si solo sigues una.

• weekly_report

  Informe semanal de visibilidad en IA: dónde estás, qué ha cambiado y por qué, prioridades.

• what_to_do_this_week

  Qué hacer esta semana: los tres cambios con más probabilidades de meterte en más respuestas.

• why_competitor_wins

  Por qué gana un competidor: las respuestas y fuentes reales que lo explican, y qué cambiar.

Cómo son los resultados

Páginas. Las listas devuelven items, total y next_cursor. Pasa next_cursor como cursor para la página siguiente; en la última es null. Las listas de más reciente a más antiguo (respuestas, alertas) usan la fecha y el id de cada fila, así que si entran datos nuevos mientras paginas no se repite ni se salta nada.

Resumen y detalle. search_answers devuelve un resumen por respuesta (motor, prompt, fecha, marcas nombradas y posiciones, dominios citados y el fragmento sobre ti). Lee una entera con get_answer; los artículos funcionan igual con list_articles y get_article.

Porcentajes. La visibilidad, las citas y similares son proporciones de respuestas de 0 a 1, con su intervalo de confianza del 95 %. Con pocas respuestas hay incertidumbre: los cambios vienen marcados como significativos o no.

Formato. Cada resultado llega como texto JSON y como structuredContent. Los errores que puedes corregir (un argumento mal, un límite del plan, algo que no existe) vuelven como error de la herramienta con el motivo.

Preguntas de ejemplo

• “¿Qué visibilidad tiene mi marca en las respuestas de IA este mes, y frente a quién?”
• “¿Por qué ChatGPT recomienda a mi competidor principal y no a nosotros? Enséñame las respuestas.”
• “¿En qué webs debería conseguir que me mencionen primero, y qué dicen?”
• “¿Qué ha cambiado desde la semana pasada y qué debería hacer?”
• “Añade estas cinco preguntas a los prompts que sigo.”
• “Marca como hecho el arreglo de los datos estructurados.”

Seguridad

Las conexiones y las claves pertenecen a un espacio de trabajo y solo ven sus datos. El servidor nunca inicia trabajo de pago (actualizaciones, artículos, emails): eso se queda en la app. Puedes desconectar una aplicación o revocar una clave en Integraciones cuando quieras; deja de funcionar al instante, y quien sale del espacio de trabajo pierde las aplicaciones que conectó.