Adviserry

npx add-mcp 'https://adviserry.com/api/mcp'

Documentación del Servidor MCP

Conecta Adviserry a Claude Desktop, Claude Code, Cursor, Gemini CLI u OpenClaw y tu asistente podrá buscar directamente en tus newsletters y transcripciones de YouTube. Configuración: copia tu token MCP, pega un bloque de configuración en tu cliente y reinícialo.

¿Nuevo en esto? Comienza con la descripción general del servidor MCP.

¿Qué clientes MCP admite Adviserry?

Claude Desktop, Claude Code, Cursor, Gemini CLI y OpenClaw, todos a través del mismo endpoint HTTP con un token Bearer. ChatGPT aún no es compatible: sus conectores personalizados requieren OAuth 2.1 con registro dinámico de clientes, que Adviserry no implementa actualmente. Las pestañas a continuación tienen una configuración lista para copiar para cada cliente compatible.

¿Cómo conecto Adviserry a Claude Desktop?

Para conectar tu cliente de IA a Adviserry, necesitas tu token MCP:

1. Inicia sesión en Adviserry
2. Ve a Configuración y busca la sección Acceso al Servidor MCP
3. Copia tu token MCP personal

Tu token autentica las solicitudes mediante el encabezado Authorization: Bearer <token>. Mantenlo seguro.

¿Usas un cliente diferente? Elige su pestaña a continuación; los pasos son los mismos: pega la configuración, guarda y reinicia.

Configuración de Claude Desktop

Añade esto a tu claude_desktop_config.json

{
  "mcpServers": {
    "adviserry": {
      "url": "https://adviserry.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_TOKEN"
      }
    }
  }
}

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

Reinicia Claude Desktop después de guardar los cambios.

¿Conectado? Consulta la descripción general del servidor MCP para saber qué preguntarle primero.

¿Necesito configurar esto nuevamente en mi teléfono?

Sí. Los conectores no se comparten entre Claude en escritorio y Claude en móvil, por lo que añadir Adviserry en uno no lo añade al otro. Si usas ambos, añádelo en ambos, con el mismo endpoint y el mismo token.

Hay una diferencia en el formulario. La aplicación móvil solicita un usuario además del token de autenticación y no guardará el conector hasta que ambos estén completos. Usa tu ID de usuario de Adviserry, que se encuentra en Tu ID de Usuario en la sección MCP de Configuración, junto al token.

El ID de usuario no es una segunda credencial. Las solicitudes se autentican únicamente con el token Bearer, y el servidor nunca lee el campo de usuario, por lo que no necesita protección como tu token.

¿Qué herramientas expone el servidor?

El servidor MCP de Adviserry expone 13 herramientas. Tu cliente de IA las descubrirá automáticamente una vez conectado.

search_newsletters

Busca contenido relevante en la base de conocimientos de newsletters del usuario. Úsalo para encontrar información, citas o ideas de los newsletters a los que el usuario está suscrito.

Parámetro	Tipo	Obligatorio	Descripción
query	string	Sí	La consulta de búsqueda para encontrar contenido relevante de newsletters
panel_name	string	No	Opcional: Filtrar por un nombre de panel específico (p. ej., 'Marketing', 'Tech')
limit	string	No	Número máximo de resultados a devolver (predeterminado: 5, máximo: 10)

list_panels

Lista todos los paneles de temas del usuario y los newsletters en cada panel.

No requiere parámetros.

get_recent_issues

Obtén los números de newsletter más recientes de un panel específico o de todos los paneles.

Parámetro	Tipo	Obligatorio	Descripción
panel_name	string	No	Opcional: Filtrar por un nombre de panel específico
days	string	No	Número de días hacia atrás a considerar (predeterminado: 7, máximo: 30)
limit	string	No	Número máximo de números a devolver (predeterminado: 10, máximo: 20)

get_newsletter_summary

Obtén un resumen de un número de newsletter específico por su ID.

Parámetro	Tipo	Obligatorio	Descripción
issue_id	string	Sí	El ID del número de newsletter a resumir

get_topics

Obtén los temas clave cubiertos en los newsletters del usuario, opcionalmente filtrados por panel o rango de tiempo.

Parámetro	Tipo	Obligatorio	Descripción
panel_name	string	No	Opcional: Filtrar por un nombre de panel específico
days	string	No	Número de días a analizar (predeterminado: 30, máximo: 90)

search_context

Busca contenido relevante en los documentos y URLs subidos por el usuario. Úsalo para encontrar información de PDFs, documentos de Word, hojas de cálculo, presentaciones o páginas web que el usuario haya añadido como contexto.

Parámetro	Tipo	Obligatorio	Descripción
query	string	Sí	La consulta de búsqueda para encontrar contenido subido relevante
panel_name	string	No	Opcional: Filtrar por un nombre de panel específico. Las subidas globales siempre se incluyen.
limit	string	No	Número máximo de resultados a devolver (predeterminado: 5, máximo: 10)

get_insights

Obtén ideas proactivas generadas por los paneles de temas del usuario. Las ideas son conexiones generadas por IA entre contenido de diferentes fuentes, tendencias y elementos de acción relevantes para lo que el usuario está trabajando.

Parámetro	Tipo	Obligatorio	Descripción
panel_name	string	No	Opcional: Filtrar por un nombre de panel específico
status	string unread | read | saved | all	No	Filtrar por estado: 'unread', 'read', 'saved' o 'all' (predeterminado: 'all')
limit	string	No	Número máximo de ideas a devolver (predeterminado: 10, máximo: 20)

search_actions

Busca en las acciones redactadas del usuario: las cosas concretas y listas para copiar y pegar que la Síntesis Semanal de Adviserry propuso que HICIERA, redactadas a partir de lo que sus fuentes publicaron y de lo que dijo que está trabajando. Esto es diferente de search_newsletters (contenido fuente crudo) y get_insights (observaciones): una acción lleva un entregable terminado, no un resumen. Úsalo siempre que el usuario pregunte qué debería estar haciendo, se refiera a algo que Adviserry sugirió, o quiera encontrar una sugerencia pasada por tema ("esa acción sobre precios", "¿qué me dijo que hiciera sobre contratación?"). Devuelve el borrador completo, para que puedas entregárselo directamente.

Parámetro	Tipo	Obligatorio	Descripción
query	string	Sí	Qué buscar, en lenguaje natural. Se busca contra el título de cada acción, su justificación de 'por qué ahora' y el borrador completo.
panel_name	string	No	Opcional: restringir a un panel (ver list_panels). Omítelo para buscar en todos los paneles.
domain	string project | investment | personal | learning	No	Opcional: restringir a un área de la vida.
effort	string quick | medium | deep	No	Opcional: restringir por tamaño. 'quick' son minutos, 'medium' es aproximadamente una hora, 'deep' es un bloque de trabajo real.
status	string open | unread | read | saved | dismissed | all	No	Qué acciones incluir: 'open' (predeterminado, todo lo no descartado), 'unread', 'read', 'saved' (el usuario la marcó como completada), 'dismissed' o 'all'.
days	string	No	Opcional: solo acciones redactadas en los últimos N días (máx. 365). Omítelo para buscar en todo el historial.
limit	string	No	Número máximo de acciones a devolver (predeterminado: 5, máximo: 10)

get_actions

Lista las acciones redactadas más recientes del usuario, primero el lote de síntesis más nuevo y dentro de un lote primero las de mayor prioridad. Úsalo para "¿en qué debería estar trabajando?", "¿qué sugirió Adviserry esta semana?" o para revisar un informe sin un tema específico en mente. Devuelve el borrador completo de cada acción. Para encontrar una acción más antigua por tema, usa search_actions.

Parámetro	Tipo	Obligatorio	Descripción
panel_name	string	No	Opcional: restringir a un panel (ver list_panels)
status	string open | unread | read | saved | dismissed | all	No	Qué acciones incluir: 'open' (predeterminado, todo lo no descartado), 'unread', 'read', 'saved', 'dismissed' o 'all'.
domain	string project | investment | personal | learning	No	Opcional: restringir a un área de la vida.
effort	string quick | medium | deep	No	Opcional: restringir por tamaño.
days	string	No	Opcional: solo acciones de los últimos N días (máx. 365). Omítelo para las más recientes sin importar la antigüedad.
limit	string	No	Número máximo de acciones a devolver (predeterminado: 10, máximo: 20)

get_action

Obtén una acción completa: el borrador completo, por qué se sugirió ahora, cada fuente de la que se construyó con autor y fecha, y la parte del contexto propio del usuario con la que se comparó. Úsalo después de search_actions o get_actions cuando el usuario quiera actuar sobre una sugerencia específica, o quiera saber de dónde proviene antes de confiar en ella.

Parámetro	Tipo	Obligatorio	Descripción
action_id	string	Sí	El id de la acción, tal como lo devuelven search_actions o get_actions.

update_action_status

Marca una de las acciones del usuario como hecha, leída, descartada o de vuelta a no leída, para que el panel y las síntesis futuras reflejen lo que realmente sucedió. Solo hazlo cuando el usuario haya dicho qué hizo con la acción. Usa 'saved' cuando la haya enviado o completado (eso es lo que el panel llama Enviada, y enseña a las síntesis futuras a redactar más como ella), 'dismissed' cuando no la va a hacer, 'read' para reconocer sin comprometerse. Cada valor es reversible.

Parámetro	Tipo	Obligatorio	Descripción
action_id	string	Sí	El id de la acción, tal como lo devuelven search_actions o get_actions.
status	string saved | dismissed | read | unread	Sí	'saved' = enviada/hecha, 'dismissed' = no la hará, 'read' = vista, 'unread' = volver a ponerla.

get_user_context

Obtén el perfil de asesor del usuario: su rol, en qué está trabajando actualmente, los desafíos que enfrenta, sus objetivos y notas libres. Este contexto lo usan los paneles para generar ideas y acciones personalizadas. Llámalo antes y después de update_context para confirmar los cambios.

No requiere parámetros.

update_context

Actualiza el perfil de contexto de 'en qué estoy trabajando' del usuario (el mismo perfil que devuelve get_user_context). Úsalo solo cuando el usuario pida explícitamente actualizar su contexto de Adviserry. Llama primero a get_user_context para ver el valor actual y luego nuevamente para confirmar el cambio. Para current_projects y challenges, separa múltiples entradas con saltos de línea o punto y coma. Para goals_detail, escribe un objetivo por línea como 'Nombre del objetivo: cómo se ve el éxito'. La actualización cuenta como una revisión humana fresca del perfil. IMPORTANTE — este perfil generalmente abarca MÁS DE UN proyecto. El usuario puede tener varios productos y apuntar diferentes paneles a cada uno, por lo que el contexto que puedes ver desde donde estás ejecutando probablemente sea solo una parte. Debido a eso: 1. Prefiere el modo 'append'. Solo usa 'replace_field' cuando el usuario haya pedido realmente limpiar el campo. 2. Cualquier actualización que eliminaría algo devuelve una VISTA PREVIA y no guarda nada. Lee la vista previa al usuario, repasa la lista de eliminaciones con él elemento por elemento, y solo entonces llama nuevamente con el token de 'confirm' devuelto. Nunca inventes un token y nunca confirmes en nombre del usuario sin mostrarle lo que desaparece. 3. Si la solicitud del usuario realmente trata sobre un proyecto, pasa 'panels' con los nombres de panel de ese proyecto. Las entradas etiquetadas a otros paneles quedan entonces protegidas automáticamente de la eliminación.

Parámetro	Tipo	Requerido	Descripción
mode	string append | replace_field	Sí	'append' añade al campo, conservando lo que ya existe (recomendado y nunca destructivo). 'replace_field' sobrescribe el campo, lo que eliminará cualquier cosa que no esté en tu texto; primero muestra una vista previa de confirmación.
field	string role | current_projects | challenges | goals_detail | freeform	Sí	Qué parte del perfil actualizar: role (una frase sobre quién es la persona; solo replace_field), current_projects (proyectos e iniciativas), challenges (dificultades actuales), goals_detail (cómo se ve el éxito) o freeform (cualquier otra cosa, con las palabras del usuario). Los intereses no se pueden escribir aquí a propósito: el usuario los gestiona en la pestaña Context.
text	string	Sí	El contenido a escribir. Máximo 2000 caracteres por actualización (role: 500).
panels	string	No	Opcional, solo para current_projects y challenges: nombres de paneles separados por comas para etiquetar estas entradas (consulta list_panels). Las entradas etiquetadas solo informan acciones para esos paneles; las no etiquetadas pueden informar a cualquier panel. Enviar esto también protege las entradas de otros paneles de ser eliminadas. Los nombres desconocidos hacen fallar la actualización.
confirm	string	No	El token devuelto por una vista previa anterior de esta misma actualización. Requerido para aplicar cualquier cosa que elimine contexto existente. Envía el mismo campo, modo y texto que previsualizaste; cambiar el texto invalida el token y genera una nueva vista previa.
on_removal	string archive | delete	No	Qué sucede con los elementos eliminados una vez confirmados. 'archive' (predeterminado) los mantiene restaurables en la pestaña Context. 'delete' es permanente; úsalo solo cuando el usuario lo pida explícitamente.

¿Qué puedo preguntar una vez que esté conectado?

Una vez conectado, puedes preguntar a tu cliente de IA cosas como:

• "Busca en mis paneles consejos recientes sobre recaudación de fondos"
• "¿Cuáles son los últimos boletines sobre IA de mi panel Tech?"
• "Resume los problemas de esta semana de todos mis paneles"
• "¿Qué temas han cubierto mis boletines últimamente?"
• "Busca en mis documentos subidos análisis competitivo"
• "Muéstrame información no leída de mi panel Marketing"
• "Lista todos mis paneles y sus fuentes"

¿Cuáles son los límites de tasa MCP de Adviserry?

Detalle	Valor
Solicitudes por hora	500, por usuario
Intervalo de reinicio	Ventana móvil de 60 minutos
Respuesta al superar el límite	HTTP 200 con un error JSON-RPC (código -32000), no un estado HTTP distinto

¿Por qué mi cliente dice que el servidor no está disponible?

Cuatro cosas para verificar, en orden

1. Verifica que tu token MCP sea correcto (cópialo nuevo desde Configuración)
2. Asegúrate de que la URL del endpoint sea https://adviserry.com/api/mcp sin prefijo www.. El host www devuelve una redirección 308 que la mayoría de los clientes MCP no siguen, lo que aparece como un tiempo de espera de conexión.
3. Asegúrate de que el encabezado Authorization tenga el formato Bearer YOUR_TOKEN
4. Reinicia tu cliente de IA después de hacer cambios en la configuración

¿Por qué mis resultados de búsqueda están vacíos?

1. Verifica que tengas boletines o canales de YouTube añadidos a tus paneles
2. Comprueba que tu cuenta de Gmail esté conectada y sincronizada
3. Intenta ampliar tu consulta de búsqueda

Preguntas frecuentes de solución de problemas

Los problemas de conexión anteriores cubren una configuración inicial. Estos cubren lo que surge una vez que llevas un tiempo usándolo: tokens, errores que tu cliente muestra textualmente y el límite de tasa.

Regeneré mi token pero mi cliente sigue fallando. ¿Qué pasa?

Regenerar un token invalida el anterior inmediatamente, así que un cliente que aún tenga el valor anterior empieza a fallar de inmediato. Abre su configuración (claude_desktop_config.json, ~/.claude.json o la configuración MCP de tu cliente), reemplaza el valor anterior en el encabezado Authorization con el token nuevo desde Configuración, Acceso al servidor MCP, guarda y reinicia completamente el cliente en lugar de solo recargarlo.

¿Por qué mi cliente dice "Unknown tool"?

Significa que el nombre de herramienta que envió tu cliente no existe para tu cuenta. Lo más común es que tu cliente haya guardado en caché una lista de herramientas anterior de antes de que enviáramos un cambio, y reiniciarlo fuerza una búsqueda nueva que elimina el error. También es la respuesta exacta que dos herramientas de análisis solo para operadores dan a propósito, ya que las cuentas de clientes no pueden acceder a ellas de todos modos.

Alcancé el límite de tasa MCP. ¿Qué pasa y cuánto tiempo hasta que pueda intentarlo de nuevo?

Cada cuenta recibe 500 llamadas de herramienta por hora móvil, rastreadas por usuario en lugar de por cliente. Superarlo no produce un estado de error HTTP: obtienes una respuesta normal con un error JSON-RPC, código -32000, que describe el límite en su interior, así que revisa el cuerpo de la respuesta si tu cliente solo muestra códigos de estado. La ventana se mueve continuamente, así que la capacidad se libera a medida que tus llamadas más antiguas de esa hora caducan.

¿Necesito reiniciar mi cliente después de editar la configuración?

Sí. Los clientes MCP leen su archivo de configuración una vez al iniciar y mantienen la lista de servidores y herramientas para esa sesión, así que editar claude_desktop_config.json, ~/.claude.json o el panel de configuración MCP de un cliente mientras está en ejecución no tiene efecto hasta que lo cierres y lo reabras por completo. Una recarga de ventana no es lo mismo que un reinicio para la mayoría de los clientes.

¿Cómo evito errores JSON al editar el archivo de configuración en Windows?

El bloque de configuración propio de Adviserry no tiene rutas de archivo locales, solo una URL y un token bearer, así que no hay nada nuestro que escapar. Pero si claude_desktop_config.json ya lista otros servidores con rutas de archivo de Windows, recuerda que cada barra invertida dentro de una cadena JSON debe duplicarse o todo el archivo fallará al analizarse, afectando a todos los servidores, incluido Adviserry. Valida el archivo antes de reiniciar.

¿Qué formato exacto necesita el encabezado Authorization?

Exactamente Authorization: Bearer YOUR_TOKEN, con la palabra literal Bearer, una B mayúscula y un solo espacio antes del token. Sin comillas alrededor del valor y sin otro esquema. Si la configuración de tu cliente usa un objeto de encabezados en lugar de una cadena sin procesar, la clave sigue siendo Authorization y el valor es la cadena completa "Bearer token", no solo el token.

¿Cómo revoco mi token MCP?

No hay una acción de revocación separada. Regenerar tu token desde Configuración, Acceso al servidor MCP invalida inmediatamente el anterior, lo que es una revocación en todo sentido práctico: cualquier cliente que aún lo envíe fallará en su próxima solicitud. Genera el token nuevo allí, actualiza cada configuración de cliente que usara el anterior y reinicia cada cliente para aplicar el cambio.

¿Cómo mantengo seguro mi token MCP?

• Nunca confirmes tu token MCP en control de versiones ni lo compartas públicamente
• Regenera tu token inmediatamente si sospechas que se ha visto comprometido (Configuración → Acceso al servidor MCP → Regenerar token)
• Usa siempre autenticación basada en encabezados para evitar la exposición del token en URL, registros o historial del navegador
• Mantén tu cliente de IA actualizado para los últimos parches de seguridad

¿Necesitas ayuda? Contacta con soporte