KanseiLink

Capa de inteligencia MCP con 156 servicios, puntuaciones de confianza basadas en uso real de agentes, 120 recetas de flujo de trabajo, descubrimiento basado en intenciones y retroalimentación de Agent Voice. SaaS global y japonés.

Documentación

Servidor MCP KanseiLink

npm version npm downloads GitHub stars

Reduce el desperdicio de tokens de tu agente de IA con inteligencia colectiva.

Tu agente quema tokens en tres cosas: buscar documentación de SaaS que podría consultar localmente, reintentar errores que otros agentes ya resolvieron, y releer contexto que ya procesó. KanseiLink aborda las dos primeras — y mide las tres para que sepas exactamente a dónde van tus tokens.

Ahorro medido: 89–97% en investigación de integración SaaS (promedio ~16,800 tokens sin → ~950 con KanseiLink, en 7 servicios).

Cómo Funciona

Install MCP → agent wastes fewer tokens (lookup + collective intelligence)
                    ↓
            usage data stays local (opt-in: anonymous scalars only)
                    ↓
            collective intelligence grows → everyone's agent gets smarter
  1. Mide — los hooks instalados automáticamente rastrean cada sesión: tokens totales, división de caché, bucles de error, tiempo bloqueado. Nada sale de tu máquina.
  2. Reduce — la consulta SaaS elimina el ensayo y error en integraciones de API. La inteligencia de resolución de errores (próximamente) previene fallos repetidos en toda la comunidad.
  3. Compara — el informe mensual opcional "Wrapped" muestra a dónde fueron tus tokens y cómo te posicionas entre los usuarios medidos.

Si KanseiLink ahorra tokens a tu agente, dale una estrella ⭐ — más de 700 desarrolladores lo instalan desde npm cada mes, y las estrellas son cómo el próximo lo encuentra.

Inicio Rápido

npx @kansei-link/mcp-server

Funciona con Claude Code, Cursor, Cline, Zed, Windsurf — cualquier cliente MCP.

Añádelo a tu configuración (claude_desktop_config.json, .cursor/mcp.json, etc.):

{
  "mcpServers": {
    "kansei-link": {
      "command": "npx",
      "args": ["-y", "@kansei-link/mcp-server"]
    }
  }
}

O con la CLI de Claude Code:

claude mcp add -s user kansei-link -- npx -y @kansei-link/mcp-server

Wrapped: Tu Informe Mensual de Eficiencia de Combustible del Agente

KanseiLink mide — localmente, en tu máquina — cuántos tokens consumen las sesiones de tu agente y cuánto de eso te ahorró KanseiLink, y luego genera una tarjeta mensual "Wrapped" para compartir.

1. Instala los hooks de medición (un comando, idempotente, hace copia de seguridad de tu configuración primero):

npx -y -p @kansei-link/mcp-server kansei-link-install-hooks

Esto añade un hook Stop/SessionEnd que analiza cada transcripción de sesión y escribe totales de tokens + estadísticas de llamadas de KanseiLink en ~/.kansei-link/usage/. No se sube nada.

2. Consulta tu informe en cualquier momento:

npx -y -p @kansei-link/mcp-server kansei-link-wrapped            # current month (JA)
npx -y -p @kansei-link/mcp-server kansei-link-wrapped --lang en  # English
npx -y -p @kansei-link/mcp-server kansei-link-wrapped --share    # opt-in: get your rank

El informe separa los números medidos (tus tokens totales, conteos de llamadas de KanseiLink y tamaños de respuesta — analizados de tus propias transcripciones) de los estimados (el costo evitado de investigación web, basado en el benchmark del 2026-04-16 freee/kintone/smarthr) — las etiquetas se muestran en cada superficie.

También muestra dónde se quedó atascado tu agente: llamadas de herramienta fallidas, cadenas de reintentos (2+ fallos consecutivos de la misma herramienta), los tokens quemados mientras estaba atascado, y tus herramientas con más fallos.

--share envía solo agregados escalares mensuales (id anónimo + conteos de tokens, nunca contenido) y devuelve tu posición entre los usuarios medidos ("ahorrador top X%"). Por debajo de 20 usuarios medidos en el mes, obtienes el tamaño del grupo en lugar de una posición.

Desactiva la medición en cualquier momento: export KANSEI_USAGE_HOOK=off, o kansei-link-install-hooks --remove.

Inteligencia de Integración SaaS

La razón principal por la que los agentes desperdician tokens en APIs SaaS: buscan documentación, adivinan flujos de autenticación y se recuperan de errores — cada vez. KanseiLink incluye una base de datos SQLite local para que tu agente obtenga la respuesta al primer intento.

CantidadDescripción
Servicios11,000+Servidores MCP y APIs SaaS en 23 categorías (2,257 verificados por MCP mediante handshake)
Recetas200Composiciones de flujos de trabajo multi-servicio (standup, revisión de PR, respuesta a incidentes, onboarding...)
Guías de API199Configuración de autenticación, endpoints, límites de tasa, trampas y soluciones alternativas
Puntajes de confianzaSemanalBasados en sondas de salud automatizadas + datos reales de uso de agentes

Todos los datos viajan dentro del paquete npm como una base de datos SQLite local. No se necesitan llamadas API. Sin dependencia de servidor, sin registro.

Sin vs. Con KanseiLink

Sin KanseiLinkCon KanseiLink
web_search "autenticación API freee"search_services({ intent: "send invoice" })
web_fetch página de inicio de documentación (SPA, mayormente navegación)lookup({ service_id: "freee" })
web_fetch referencia de endpointsEl agente tiene flujo de autenticación, trampas, soluciones alternativas
web_fetch guía de autenticaciónen ~950 tokens
Ensayo y error con parámetros incorrectosEl primer intento tiene éxito
~16,800 tokens quemados89–97% ahorrado

Claude Code: instala la skill (invocación automática)

Instalar solo el MCP no le enseña a Claude Code cuándo llamar a KanseiLink. La skill incluida lo soluciona:

npx -y -p @kansei-link/mcp-server kansei-link-install-skill

Esto copia un SKILL.md a ~/.claude/skills/kansei-link/. Claude Code lo descubre automáticamente y activa la skill con frases como "conectar a Stripe", "¿hay MCP de Slack?", "enviar factura vía freee" — sin necesidad de decir "usa KanseiLink".

Opcional: hook PostToolUse

Captura automática de éxito/fallo después de cada llamada MCP (los agentes tienden a olvidar reportar).

Consentimiento (v1.2, CAMBIO IMPORTANTE). Instalar el hook ya no transmite nada por sí solo. Toda transmisión central está gobernada por una puerta de consentimiento (~/.kansei-link/consent.json), con esta prioridad: DO_NOT_TRACK=1 / OFF explícito → ON explícito (KANSEI_REPORT_HOOK=on) → consentimiento de Actualizaciones en Vivo (npx -y -p @kansei-link/mcp-server kansei-link-live-updates --enable) → OFF por defecto (Modo Local, transmisión cero). Los usuarios existentes del hook están en OFF hasta que vuelvan a dar su consentimiento. Gestiona: kansei-link-live-updates --status|--enable|--disable, kansei-link-privacy --status|--reset-id.

Qué envía este hook cuando está habilitado (y qué nunca envía). Un pequeño evento seudónimo al endpoint alojado de KanseiLink después de cada llamada de herramienta MCP. La carga útil es un conjunto fijo de 7 campos, congelado por una prueba de instantánea (scripts/smoke-hook-payload.mjs):

  • enviado: slug del servicio (o nombre del servidor MCP), éxito/fallo, nombre de la herramienta, categoría de error (ej. auth_error), una cadena de contexto fija
  • nunca enviado: prompts, entradas/salidas de herramientas, nombres de páginas/clientes/registros, claves API, rutas de archivos, texto libre de cualquier tipo. No se adjunta ningún identificador de cuenta o máquina.

Instalar el hook NO te da de alta — la transmisión requiere la puerta de consentimiento anterior (consentimiento de Actualizaciones en Vivo, o un KANSEI_REPORT_HOOK=on explícito). Desactiva en cualquier momento: kansei-link-live-updates --disable o export KANSEI_REPORT_HOOK=off.

Añade a ~/.claude/settings.json:

{
  "hooks": {
    "PostToolUse": [{
      "matcher": "mcp__.*",
      "hooks": [{ "type": "command", "command": "npx -y -p @kansei-link/mcp-server kansei-link-report-hook" }]
    }]
  }
}

Desactiva en cualquier momento: export KANSEI_REPORT_HOOK=off

Herramientas (5)

v1.0 consolida la superficie de herramientas de 25 herramientas individuales a 5 herramientas unificadas con detección automática de modo.

Flujo Estándar (3 herramientas — todo lo que necesitas)

search_services --> lookup --> (execute your API call) --> report
HerramientaModosDescripción
search_services--Encuentra servicios por intención (FTS5 + trigrama + refuerzo de categoría)
lookup8 modosObtén consejos, detalle, información, recetas, combinaciones, historial, comentarios, voces
report4 modosReporta resultados, envía comentarios, registra eventos, comparte tu voz

Herramientas de Administración (2 adicionales)

HerramientaModosDescripción
inspect8 modosSalud de la colonia: cola de inspección, verificación de anomalías, propuestas de actualización, instantáneas
analyze4 modosAnalítica: ahorro de tokens, auditoría de costos, informes y artículos AEO

Modos de Consulta

ModoDisparadorEjemplo
tips (predeterminado)service_id sololookup({ service_id: "freee" })
detaildetail: truelookup({ service_id: "freee", detail: true })
insightsinsights: truelookup({ service_id: "freee", insights: true })
recipegoallookup({ goal: "onboard employee" })
combinationsservice (nombre difuso)lookup({ service: "freee" })
historyperiodlookup({ service_id: "freee", period: "30d" })
feedbackfeedback_statuslookup({ feedback_status: "open" })
voicesmode: "voices"lookup({ mode: "voices", service_id: "freee" })

Modos de Reporte

ModoDisparadorEjemplo
outcomesuccess (booleano)report({ service_id: "freee", success: true })
feedbacksubject + bodyreport({ subject: "...", body: "..." })
eventevent_typereport({ event_type: "api_change", event_date: "2025-01-15", title: "..." })
voicequestion_idreport({ question_id: "best_feature", response_text: "...", service_id: "freee" })

Flujos de Trabajo de Ejemplo

Encuentra e integra un servicio:

search_services({ intent: "send invoice to clients", compact: true })
--> lookup({ service_id: "freee" })        // tips: auth, pitfalls, workarounds
--> lookup({ service_id: "freee", detail: true })  // full connection guide
--> (execute your API call)
--> report({ service_id: "freee", success: true, task_type: "create_invoice" })

Flujo de trabajo multi-servicio:

lookup({ goal: "create invoice and notify via slack", services: ["freee", "slack"] })
--> Step-by-step recipe with coverage scoring

Comparte tu opinión honesta:

report({
  service_id: "stripe",
  question_id: "biggest_frustration",
  response_text: "Webhook signature verification docs are unclear for non-Node runtimes"
})

Categorías (23)

CRM, Gestión de Proyectos, Comunicación, Contabilidad, RRHH, Comercio Electrónico, Legal, Marketing, Groupware, Productividad, Almacenamiento, Soporte, Pagos, Logística, Reservas, Integración de Datos, BI/Análisis, Seguridad, Herramientas de Desarrollo, IA/ML, Base de Datos, Diseño, DevOps

Arquitectura

Agent <-> KanseiLink MCP Server <-> SQLite (local, zero-config)
              |
              +-- search_services  -> FTS5 + trigram (CJK) + LIKE + category detection
              +-- lookup           -> tips / detail / insights / recipe / combinations /
              |                       history / feedback / voices (auto-detected)
              +-- report           -> outcome / feedback / event / voice (auto-detected)
              +-- inspect          -> queue / submit / propose / review / snapshot / evaluate
              +-- analyze          -> token_savings / cost / aeo_report / aeo_article

Para Empresas SaaS

KanseiLink funciona también como una plataforma de evaluación de Índice de Preparación para Agentes (ARI). Los agentes reales que usan APIs reales generan telemetría objetiva — tasas de éxito, latencia, patrones de error y rutas de resolución — que ninguna encuesta o benchmark puede replicar.

Lo que podemos mostrarte:

  • Tasa de éxito del agente para tu API a lo largo del tiempo
  • Patrones de error y cómo los agentes los resuelven
  • Voz del Agente: por qué los agentes eligen (o evitan) tu servicio
  • Posición en la categoría frente a competidores
  • Impacto de los cambios de API (análisis antes/después)

Estos datos provienen del mismo MCP que ahorra tokens a los desarrolladores individuales — la inteligencia colectiva que ayuda a los agentes es la misma señal que evalúa los servicios.

Consulta kansei-link.com o contáctanos.

Privacidad y Manejo de Datos

KanseiLink es respetuoso con la privacidad por defecto:

  • Local primero: la base de datos completa del servicio viaja dentro del paquete npm. No se necesitan llamadas API.
  • La medición permanece local: el hook de uso escribe en ~/.kansei-link/usage/ en tu máquina. No se sube nada a menos que optes con --share, que envía solo agregados escalares (conteos de tokens), nunca contenido.
  • Enmascaramiento automático de PII: cada llamada report limpia correos electrónicos, números de teléfono, direcciones IP y nombres japoneses antes del almacenamiento.
  • Identidad del agente anonimizada: solo se conserva el tipo de agente (claude / gpt / gemini) — nunca el ID de usuario.
  • Sin telemetría por defecto: el servidor stdio local no se comunica con el exterior.

Consulta SECURITY.md para más detalles.

Solución de Problemas

La skill no se activa — Claude Code no llama a KanseiLink cuando pregunto sobre SaaS.
  1. Verifica que la skill esté instalada:
    ls ~/.claude/skills/kansei-link/SKILL.md
    
    Si no está, ejecuta npx -y -p @kansei-link/mcp-server kansei-link-install-skill.
  2. Reinicia Claude Code. Las skills se indexan al inicio de la sesión.
  3. Verifica que el MCP esté registrado con el nombre kansei-link:
    claude mcp add -s user kansei-link -- npx -y @kansei-link/mcp-server
    
search_services no devuelve nada para un servicio que sé que existe.
  1. Prueba el filtro de categoría: search_services({ intent: "...", category: "accounting" }).
  2. Prueba el equivalente en inglés — la mayoría de las entradas están indexadas bilingüemente, pero algunas solo en EN.
  3. Si el servicio realmente no está, envía comentarios: report({ subject: "Missing: ServiceX", body: "..." }).
Error de autenticación al llamar a un endpoint SaaS después de que KanseiLink lo sugirió.
  1. Comienza con lookup({ service_id: "..." }) — devuelve trampas de OAuth conocidas y soluciones alternativas para tokens de actualización.
  2. Reporta el fallo: report({ service_id: "...", success: false, error_type: "auth_error", workaround: "..." }) — tu solución ayuda al próximo agente.

Contribuciones

git clone https://github.com/kansei-link/kansei-mcp-server.git
cd kansei-mcp-server
npm install
npm run build
npm start       # start stdio server

Se aceptan PRs. Si encuentras un servicio que falta o tiene información incorrecta, el camino más rápido es:

report({ subject: "Fix: ServiceX auth is OAuth2 not API key", body: "..." })

Enlaces

Licencia

MIT — Synapse Arrows PTE. LTD.