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
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
- 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.
- 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.
- 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.
| Cantidad | Descripción | |
|---|---|---|
| Servicios | 11,000+ | Servidores MCP y APIs SaaS en 23 categorías (2,257 verificados por MCP mediante handshake) |
| Recetas | 200 | Composiciones de flujos de trabajo multi-servicio (standup, revisión de PR, respuesta a incidentes, onboarding...) |
| Guías de API | 199 | Configuración de autenticación, endpoints, límites de tasa, trampas y soluciones alternativas |
| Puntajes de confianza | Semanal | Basados 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 KanseiLink | Con 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 endpoints | El agente tiene flujo de autenticación, trampas, soluciones alternativas |
web_fetch guía de autenticación | en ~950 tokens |
| Ensayo y error con parámetros incorrectos | El primer intento tiene éxito |
| ~16,800 tokens quemados | 89–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
| Herramienta | Modos | Descripción |
|---|---|---|
search_services | -- | Encuentra servicios por intención (FTS5 + trigrama + refuerzo de categoría) |
lookup | 8 modos | Obtén consejos, detalle, información, recetas, combinaciones, historial, comentarios, voces |
report | 4 modos | Reporta resultados, envía comentarios, registra eventos, comparte tu voz |
Herramientas de Administración (2 adicionales)
| Herramienta | Modos | Descripción |
|---|---|---|
inspect | 8 modos | Salud de la colonia: cola de inspección, verificación de anomalías, propuestas de actualización, instantáneas |
analyze | 4 modos | Analítica: ahorro de tokens, auditoría de costos, informes y artículos AEO |
Modos de Consulta
| Modo | Disparador | Ejemplo |
|---|---|---|
| tips (predeterminado) | service_id solo | lookup({ service_id: "freee" }) |
| detail | detail: true | lookup({ service_id: "freee", detail: true }) |
| insights | insights: true | lookup({ service_id: "freee", insights: true }) |
| recipe | goal | lookup({ goal: "onboard employee" }) |
| combinations | service (nombre difuso) | lookup({ service: "freee" }) |
| history | period | lookup({ service_id: "freee", period: "30d" }) |
| feedback | feedback_status | lookup({ feedback_status: "open" }) |
| voices | mode: "voices" | lookup({ mode: "voices", service_id: "freee" }) |
Modos de Reporte
| Modo | Disparador | Ejemplo |
|---|---|---|
| outcome | success (booleano) | report({ service_id: "freee", success: true }) |
| feedback | subject + body | report({ subject: "...", body: "..." }) |
| event | event_type | report({ event_type: "api_change", event_date: "2025-01-15", title: "..." }) |
| voice | question_id | report({ 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
reportlimpia 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.
- Verifica que la skill esté instalada:
Si no está, ejecutals ~/.claude/skills/kansei-link/SKILL.mdnpx -y -p @kansei-link/mcp-server kansei-link-install-skill. - Reinicia Claude Code. Las skills se indexan al inicio de la sesión.
- 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.
- Prueba el filtro de categoría:
search_services({ intent: "...", category: "accounting" }). - Prueba el equivalente en inglés — la mayoría de las entradas están indexadas bilingüemente, pero algunas solo en EN.
- 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ó.
- Comienza con
lookup({ service_id: "..." })— devuelve trampas de OAuth conocidas y soluciones alternativas para tokens de actualización. - 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
- npm
- Sitio web
- Registro MCP:
io.github.kansei-link/kansei-mcp-server - Glama
Licencia
MIT — Synapse Arrows PTE. LTD.