KanseiLink

Servidor MCP KanseiLink

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

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

Economia medida: 89–97% na 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. Meça — 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. Reduza — a consulta SaaS elimina tentativa e erro em integrações de API. Inteligência de resolução de erros (em breve) previne falhas repetidas na comunidade.
3. Compare — relatório mensal "Wrapped" opcional 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 instalam pelo npm todo mês, e as estrelas são como o próximo usuário 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 renderiza um cartão mensal "Wrapped" para compartilhar.

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

npx -y -p @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 -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

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

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

--share envia apenas agregados escalares mensais (id anônimo + contagens de tokens, nunca conteúdo) e retorna sua classificação entre os usuários medidos ("top X% economizador"). Abaixo de 20 usuários medidos no mês, você recebe o tamanho do grupo 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 central de os agentes desperdiçarem 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.

	Quantidade	Descrição
Serviços	11.000+	Servidores MCP e APIs SaaS em 23 categorias (2.257 verificados via MCP handshake)
Receitas	200	Composições de fluxos de trabalho multi-serviço (standup, revisão de PR, resposta a incidentes, onboarding...)
Guias de API	199	Configuração de autenticação, endpoints, limites de taxa, armadilhas e soluções alternativas
Pontuações de Confiança	Semanal	Baseadas 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 KanseiLink	Com KanseiLink
web_search "autenticação da API freee"	search_services({ intent: "send invoice" })
web_fetch página inicial da documentação (SPA, principalmente navegação)	lookup({ service_id: "freee" })
web_fetch referência de endpoints	O agente tem fluxo de autenticação, armadilhas, soluções alternativas
web_fetch guia de autenticação	em ~950 tokens
Tentativa e erro em parâmetros errados	Primeira tentativa bem-sucedida
~16.800 tokens queimados	89–97% economizados

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

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

npx -y -p @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 dispara a skill em frases como "conectar ao Stripe", "Slack MCPある？", "enviar fatura 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, MUDANÇA IMPORTANTE). Instalar o hook sozinho não transmite mais nada. Toda transmissão central é governada por uma 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 Atualizações ao Vivo (npx -y -p @kansei-link/mcp-server kansei-link-live-updates --enable) → padrão OFF (Modo Local, transmissão zero). Usuários existentes do hook ficam OFF até reconsentirem. Gerenciar: kansei-link-live-updates --status|--enable|--disable, kansei-link-privacy --status|--reset-id.

O que este hook envia quando ativado (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 arquivos, texto livre de qualquer tipo. Nenhum identificador de conta ou máquina é anexado.

Instalar o hook NÃO significa aceitar — a transmissão exige a porta de consentimento acima (consentimento de Atualizações ao Vivo, ou um KANSEI_REPORT_HOOK=on explícito). Desative a qualquer momento: kansei-link-live-updates --disable ou export KANSEI_REPORT_HOOK=off.

Adicione ao ~/.claude/settings.json:

{
  "hooks": {
    "PostToolUse": [{
      "matcher": "mcp__.*",
      "hooks": [{ "type": "command", "command": "npx -y -p @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

Ferramenta	Modos	Descrição
search_services	--	Encontre serviços por intenção (FTS5 + trigrama + reforço de categoria)
lookup	8 modos	Obtenha dicas, detalhes, insights, receitas, combinações, histórico, feedback, vozes
report	4 modos	Reporte resultados, envie feedback, registre eventos, compartilhe sua voz

Ferramentas de Administração (2 adicionais)

Ferramenta	Modos	Descrição
inspect	8 modos	Saúde da colônia: fila de inspeção, verificação de anomalias, propostas de atualização, snapshots
analyze	4 modos	Análises: economia de tokens, auditoria de custos, relatórios e artigos AEO

Modos de Consulta

Modo	Gatilho	Exemplo
dicas (padrão)	service_id sozinho	lookup({ service_id: "freee" })
detalhes	detail: true	lookup({ service_id: "freee", detail: true })
insights	insights: true	lookup({ service_id: "freee", insights: true })
receita	goal	lookup({ goal: "onboard employee" })
combinações	service (nome difuso)	lookup({ service: "freee" })
histórico	period	lookup({ service_id: "freee", period: "30d" })
feedback	feedback_status	lookup({ feedback_status: "open" })
vozes	mode: "voices"	lookup({ mode: "voices", service_id: "freee" })

Modos de Relatório

Modo	Gatilho	Exemplo
resultado	success (booleano)	report({ service_id: "freee", success: true })
feedback	subject + body	report({ subject: "...", body: "..." })
evento	event_type	report({ event_type: "api_change", event_date: "2025-01-15", title: "..." })
voz	question_id	report({ 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, Reservas, Integração de Dados, BI/Análises, 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 para 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 na categoria vs. concorrentes
• Impacto de mudanças na API (análise antes/depois)

Esses dados vêm do mesmo MCP que economiza tokens de desenvolvedores individuais — a inteligência coletiva que ajuda os 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 primeiro: o banco de dados completo do serviço vem dentro do pacote npm. Sem chamadas de API necessárias.
• Medição permanece local: o hook de uso grava em ~/.kansei-link/usage/ na sua máquina. Nada é enviado a menos que você aceite 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 externo.

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 -p @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 em dois idiomas, 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 após o KanseiLink sugerir.

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 ausente ou com informações erradas, o caminho mais rápido é:

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

Links

• npm
• Site
• Registro MCP: io.github.kansei-link/kansei-mcp-server
• Glama

Licença

MIT — Synapse Arrows PTE. LTD.