KanseiLink

Camada de inteligência MCP com 156 serviços, pontuações de confiança baseadas no uso real de agentes, 120 receitas de fluxo de trabalho, descoberta baseada em intenção e feedback por Agent Voice. SaaS global + japonês.

GitHub
1
Experimente este MCPPatrocinado

Documentação

Servidor MCP KanseiLink

npm version npm downloads GitHub stars

Reduza o desperdício de tokens do seu agente de IA com inteligência coletiva.

Seu agente gasta tokens em três coisas: procurar documentação de SaaS que ele poderia consultar localmente, repetir erros que outros agentes já resolveram e reler contexto que ele já processou. O KanseiLink resolve as duas primeiras — e mede as três para que você saiba exatamente para onde vão seus tokens.

Economia medida: 89–97% em pesquisa de integração SaaS (média de ~16.800 tokens sem → ~950 com KanseiLink, em 7 serviços).

Como 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. Medir — hooks instalados automaticamente rastreiam cada sessão: total de tokens, divisão de cache, loops de erro, tempo travado. Nada sai da sua máquina.
  2. Reduzir — a consulta SaaS elimina tentativa e erro em integrações de API. Inteligência de resolução de erros (em breve) evita falhas repetidas na comunidade.
  3. Comparar — relatório mensal opcional "Wrapped" mostra para onde seus tokens foram e como você se classifica entre os usuários medidos.

Se o KanseiLink economizar tokens do seu agente, dê uma estrela ⭐ — mais de 700 desenvolvedores o instalam do npm todos os meses, e as estrelas são como o próximo o encontra.

Início Rápido

npx @kansei-link/mcp-server

Funciona com Claude Code, Cursor, Cline, Zed, Windsurf — qualquer cliente MCP.

Adicione à sua configuração (claude_desktop_config.json, .cursor/mcp.json, etc.):

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

Ou com a CLI do Claude Code:

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

Wrapped: Seu Relatório Mensal de Eficiência de Combustível do Agente

O KanseiLink mede — localmente, na sua máquina — quantos tokens suas sessões de agente consomem e quanto disso o KanseiLink economizou para você, e então gera um cartão de compartilhamento mensal "Wrapped".

1. Instale os hooks de medição (um comando, idempotente, faz backup das suas configurações primeiro):

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

Isso adiciona um hook Stop/SessionEnd que analisa cada transcrição de sessão e grava totais de tokens + estatísticas de chamadas do KanseiLink em ~/.kansei-link/usage/. Nada é enviado.

2. Veja seu relatório a qualquer momento:

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

O relatório separa números medidos (seus tokens totais, contagens de chamadas do KanseiLink e tamanhos de resposta — analisados de suas próprias transcrições) dos estimados (o custo evitado de pesquisa na web, com base no benchmark freee/kintone/smarthr de 2026-04-16) — rótulos mostrados em todas as superfícies.

Ele também mostra onde seu agente ficou travado: chamadas de ferramenta com falha, cadeias de repetição (2+ falhas consecutivas da mesma ferramenta), os tokens queimados enquanto travado e suas ferramentas com mais falhas.

--share envia apenas agregados mensais escalares (id anônimo + contagens de tokens, nunca conteúdo) e retorna como você se classifica entre os usuários medidos ("top X% economizador"). Abaixo de 20 usuários medidos no mês, você recebe o tamanho da coorte em vez de uma classificação.

Desative a medição a qualquer momento: export KANSEI_USAGE_HOOK=off, ou kansei-link-install-hooks --remove.

Inteligência de Integração SaaS

O motivo principal pelo qual agentes desperdiçam tokens em APIs SaaS: eles procuram documentação, adivinham fluxos de autenticação e se recuperam de erros — toda vez. O KanseiLink inclui um banco de dados SQLite local para que seu agente obtenha a resposta na primeira tentativa.

ContagemDescrição
Serviços11.000+Servidores MCP e APIs SaaS em 23 categorias (2.257 verificados via handshake MCP)
Receitas200Composições de fluxo de trabalho multi-serviço (standup, revisão de PR, resposta a incidentes, onboarding...)
Guias de API199Configuração de autenticação, endpoints, limites de taxa, armadilhas e soluções alternativas
Pontuações de ConfiançaSemanalBaseado em sondas de saúde automatizadas + dados reais de uso de agentes

Todos os dados vêm dentro do pacote npm como um banco de dados SQLite local. Zero chamadas de API necessárias. Sem dependência de servidor, sem cadastro.

Sem vs. Com KanseiLink

Sem KanseiLinkCom KanseiLink
web_search "freee API auth"search_services({ intent: "send invoice" })
web_fetch página de destino da documentação (SPA, principalmente navegação)lookup({ service_id: "freee" })
web_fetch referência de endpointO agente tem fluxo de autenticação, armadilhas e soluções alternativas
web_fetch guia de autenticaçãoem ~950 tokens
Tentativa e erro em parâmetros erradosA primeira tentativa é bem-sucedida
~16.800 tokens queimados89–97% economizados

Claude Code: instale a skill (invocação automática)

Instalar o MCP sozinho não ensina o Claude Code quando chamar o KanseiLink. A skill incluída resolve isso:

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

Isso copia um SKILL.md para ~/.claude/skills/kansei-link/. O Claude Code o descobre automaticamente e aciona a skill em frases como "connect to Stripe", "Slack MCPある？", "send invoice via freee" — sem precisar dizer "use KanseiLink".

Opcional: hook PostToolUse

Captura automática de sucesso/falha após cada chamada MCP (agentes tendem a esquecer de reportar).

Consentimento (v1.2, QUEBRA). Instalar o hook sozinho não transmite mais nada. Toda transmissão central é governada por uma única porta de consentimento (~/.kansei-link/consent.json), com esta prioridade: DO_NOT_TRACK=1 / OFF explícito → ON explícito (KANSEI_REPORT_HOOK=on) → consentimento de Live Updates (npx -y @kansei-link/mcp-server kansei-link-live-updates --enable) → padrão OFF (Modo Local, zero transmissão). Usuários existentes do hook ficam OFF até reconsentirem. Gerencie: kansei-link-live-updates --status|--enable|--disable, kansei-link-privacy --status|--reset-id.

O que este hook envia quando habilitado (e o que nunca envia). Um pequeno evento pseudônimo para o endpoint hospedado do KanseiLink após cada chamada de ferramenta MCP. O payload é um conjunto fixo de 7 campos, congelado por um teste de snapshot (scripts/smoke-hook-payload.mjs):

  • enviado: slug do serviço (ou nome do servidor MCP), sucesso/falha, nome da ferramenta, categoria de erro (ex.: auth_error), uma string de contexto fixa
  • nunca enviado: prompts, entradas/saídas de ferramentas, nomes de páginas/clientes/registros, chaves de API, caminhos de arquivo, texto livre de qualquer tipo. Nenhum identificador de conta ou máquina é anexado.

Instalar o hook NÃO faz você optar por participar — a transmissão exige a porta de consentimento acima (consentimento de Live Updates, ou um KANSEI_REPORT_HOOK=on explícito). Desative a qualquer momento: kansei-link-live-updates --disable ou export KANSEI_REPORT_HOOK=off.

Adicione a ~/.claude/settings.json:

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

Desative a qualquer momento: export KANSEI_REPORT_HOOK=off

Ferramentas (5)

A v1.0 consolida a superfície de ferramentas de 25 ferramentas individuais em 5 ferramentas unificadas com detecção automática de modo.

Fluxo Padrão (3 ferramentas — tudo que você precisa)

search_services --> lookup --> (execute your API call) --> report
FerramentaModosDescrição
search_services--Encontre serviços por intenção (FTS5 + trigrama + reforço de categoria)
lookup8 modosObtenha dicas, detalhes, insights, receitas, combinações, histórico, feedback, vozes
report4 modosReporte resultados, envie feedback, registre eventos, compartilhe sua voz

Ferramentas de Administração (2 adicionais)

FerramentaModosDescrição
inspect8 modosSaúde da colônia: fila de inspeção, verificação de anomalias, propostas de atualização, snapshots
analyze4 modosAnalytics: economia de tokens, auditoria de custos, relatórios e artigos AEO

Modos de Consulta

ModoGatilhoExemplo
tips (padrão)service_id sozinholookup({ service_id: "freee" })
detaildetail: truelookup({ service_id: "freee", detail: true })
insightsinsights: truelookup({ service_id: "freee", insights: true })
recipegoallookup({ goal: "onboard employee" })
combinationsservice (nome aproximado)lookup({ service: "freee" })
historyperiodlookup({ service_id: "freee", period: "30d" })
feedbackfeedback_statuslookup({ feedback_status: "open" })
voicesmode: "voices"lookup({ mode: "voices", service_id: "freee" })

Modos de Relatório

ModoGatilhoExemplo
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" })

Exemplos de Fluxos de Trabalho

Encontre e integre um serviço:

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" })

Fluxo de trabalho multi-serviço:

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

Compartilhe sua opinião honesta:

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

Categorias (23)

CRM, Gerenciamento de Projetos, Comunicação, Contabilidade, RH, E-commerce, Jurídico, Marketing, Groupware, Produtividade, Armazenamento, Suporte, Pagamento, Logística, Reserva, Integração de Dados, BI/Analytics, Segurança, Ferramentas de Desenvolvedor, IA/ML, Banco de Dados, Design, DevOps

Arquitetura

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

O KanseiLink também funciona como uma plataforma de avaliação de Índice de Prontidão de Agentes (ARI). Agentes reais usando APIs reais geram telemetria objetiva — taxas de sucesso, latência, padrões de erro e caminhos de resolução — que nenhuma pesquisa ou benchmark consegue replicar.

O que podemos mostrar a você:

  • Taxa de sucesso do agente para sua API ao longo do tempo
  • Padrões de erro e como os agentes os contornam
  • Voz do Agente: por que os agentes escolhem (ou evitam) seu serviço
  • Classificação de categoria vs concorrentes
  • Impacto de mudanças na API (análise antes/depois)

Esses dados vêm do mesmo MCP que economiza tokens para desenvolvedores individuais — a inteligência coletiva que ajuda agentes é o mesmo sinal que avalia serviços.

Veja kansei-link.com ou entre em contato.

Privacidade e Tratamento de Dados

O KanseiLink é preservador de privacidade por padrão:

  • Local-first: o banco de dados completo do serviço vem dentro do pacote npm. Nenhuma chamada de API necessária.
  • A medição permanece local: o hook de uso grava em ~/.kansei-link/usage/ na sua máquina. Nada é enviado a menos que você opte por participar com --share, que envia apenas agregados escalares (contagens de tokens), nunca conteúdo.
  • Mascaramento automático de PII: toda chamada report remove e-mails, números de telefone, endereços IP e nomes japoneses antes do armazenamento.
  • Identidade do agente anonimizada: apenas o tipo de agente (claude / gpt / gemini) é retido — nunca o ID do usuário.
  • Sem telemetria por padrão: o servidor stdio local não faz contato com a central.

Veja SECURITY.md para detalhes completos.

Solução de Problemas

A skill não está disparando — o Claude Code não chama o KanseiLink quando pergunto sobre SaaS.
  1. Verifique se a skill foi instalada: 
    ls ~/.claude/skills/kansei-link/SKILL.md
    Se ausente, execute npx -y @kansei-link/mcp-server kansei-link-install-skill.
  2. Reinicie o Claude Code. As skills são indexadas no início da sessão.
  3. Verifique se o MCP está registrado sob o nome kansei-link: 
    claude mcp add -s user kansei-link -- npx -y @kansei-link/mcp-server
search_services não retorna nada para um serviço que sei que existe.
  1. Tente o filtro de categoria: search_services({ intent: "...", category: "accounting" }).
  2. Tente o equivalente em inglês — a maioria das entradas é indexada bilingue, mas algumas apenas em EN.
  3. Se o serviço realmente não estiver lá, envie feedback: report({ subject: "Missing: ServiceX", body: "..." }).
Erro de autenticação ao chamar um endpoint SaaS depois que o KanseiLink o sugere.
  1. Comece com lookup({ service_id: "..." }) — ele retorna armadilhas conhecidas de OAuth e soluções alternativas para refresh-token.
  2. Reporte a falha: report({ service_id: "...", success: false, error_type: "auth_error", workaround: "..." }) — sua correção ajuda o próximo agente.

Contribuindo

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

PRs são bem-vindos. Se você encontrar um serviço que está faltando ou com informações erradas, o caminho mais rápido é:

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

Links

Licença

MIT — Synapse Arrows PTE. LTD.