Zihin

ai.zihin由 zihin.ai 发布官方发布者v2.2.2更新于 Oct 28, 2026

Chat with your Zihin.ai agents, list them and load platform skills from any MCP client.

已验证Streamable HTTP可网页运行开发者工具AI 与机器学习

概览

AI 生成的概览

把 MCP 客户端连接到 Zihin.ai 平台，让助手与你的智能体对话、列出智能体并加载平台技能。

可以做什么
  • 与 Zihin.ai 智能体对话，支持跨轮次的会话延续
  • 列出租户下的智能体以及可用的 LLM 模型目录
  • 读取 schema 模板和各类型载荷的正式 JSON Schema 契约
  • 以资源形式加载流程化技能（创建智能体、工具、触发器、诊断、治理）
  • 使用内置提示完成创建智能体、为智能体添加工具、配置 webhook 触发器
  • 把技能安装成客户端原生格式（Claude Code、Cursor、Windsurf、Codex）
适用场景
适合已经使用 Zihin.ai 智能体、希望在 Claude Desktop、Cursor、VS Code、Codex 等 MCP 客户端里直接与智能体对话、查看其配置或获取操作指南的场景。它只是代理，可用功能取决于 API Key 的角色。
运行要求
需要从 Zihin 控制台获取的 API Key，放在 ZIHIN_API_KEY 环境变量中（远程端点使用 X-Api-Key 请求头）。本地运行需 Node.js 20 或更高版本并通过 npx 启动，且能访问 Zihin MCP 服务器。可选设置 ZIHIN_MCP_URL 和 ZIHIN_MCP_CALL_TIMEOUT_MS。
安装前请注意
API Key 可访问整个租户，其角色（admin、editor、member）决定暴露哪些工具，admin 密钥包含写入操作，请勿放入共享配置。智能体对话会消耗租户的真实 LLM 用量，集成测试也会发起两次真实对话。工具调用上限约 5 分钟，超时的轮次会被取消而非排队。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Zihin，将其添加到工作区。
  2. 连接 X-Api-Key 凭据。它们会被私密存储，绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/ai.zihin%2Fmcp-server/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "zihin": {
      "type": "http",
      "url": "https://llm.zihin.ai/mcp",
      "headers": {
        "X-Api-Key": "<YOUR_API_KEY>"
      }
    }
  }
}

README

@zihin/mcp-server

Proxy MCP stdio-to-HTTP para a plataforma Zihin.ai. Conecta clientes MCP ao Zihin MCP Server via HTTP.

[smithery badge] [zihin-mcp MCP server]

Cliente MCP <-stdio-> [@zihin/mcp-server] <-HTTP-> https://llm.zihin.ai/mcp

Inicio rapido

macOS / Linux:

bash
ZIHIN_API_KEY=zhn_live_xxx npx @zihin/mcp-server

Windows (PowerShell):

powershell
$env:ZIHIN_API_KEY="zhn_live_xxx"; npx @zihin/mcp-server

Na pratica, a maioria dos clientes MCP (Claude Desktop, Cursor, etc.) define a variavel automaticamente via bloco "env" na configuracao — nao e necessario definir manualmente no shell.

Configuracao

Claude Desktop

Adicione ao claude_desktop_config.json:

json
{  "mcpServers": {    "zihin": {      "command": "npx",      "args": ["-y", "@zihin/mcp-server"],      "env": {        "ZIHIN_API_KEY": "zhn_live_xxx"      }    }  }}

Claude Code

Adicione ao .mcp.json do projeto:

json
{  "mcpServers": {    "zihin": {      "command": "npx",      "args": ["-y", "@zihin/mcp-server"],      "env": {        "ZIHIN_API_KEY": "zhn_live_xxx"      }    }  }}

Ou via CLI (a variavel ZIHIN_API_KEY deve estar definida no shell):

bash
claude mcp add zihin -e ZIHIN_API_KEY=zhn_live_xxx -- npx -y @zihin/mcp-server

Cursor

Instalacao em 1 clique (cole na barra de endereco do navegador ou rode open '<link>'):

cursor://anysphere.cursor-deeplink/mcp/install?name=zihin&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkB6aWhpbi9tY3Atc2VydmVyIl0sImVudiI6eyJaSUhJTl9BUElfS0VZIjoiemhuX2xpdmVfeHh4In19

Troque zhn_live_xxx pela sua key nas configuracoes do MCP depois de instalar. Ou adicione ao .cursor/mcp.json:

json
{  "mcpServers": {    "zihin": {      "command": "npx",      "args": ["-y", "@zihin/mcp-server"],      "env": {        "ZIHIN_API_KEY": "zhn_live_xxx"      }    }  }}

VS Code (Copilot)

[Install in VS Code]

O botao abre o VS Code com a config pronta (troque zhn_live_xxx pela sua key). Manual: comando MCP: Add Server ou .vscode/mcp.json:

json
{  "servers": {    "zihin": {      "command": "npx",      "args": ["-y", "@zihin/mcp-server"],      "env": { "ZIHIN_API_KEY": "zhn_live_xxx" }    }  }}

Windsurf

Adicione ao ~/.windsurf/mcp.json:

json
{  "mcpServers": {    "zihin": {      "command": "npx",      "args": ["-y", "@zihin/mcp-server"],      "env": {        "ZIHIN_API_KEY": "zhn_live_xxx"      }    }  }}

Gemini CLI

bash
gemini extensions install https://github.com/zihin-ai/gemini-cli-zihin

A extensao pede a API Key na instalacao (fica no keychain) e instala o MCP + contexto. Config manual: ver "Outros clientes MCP".

Codex (OpenAI)

Adicione ao ~/.codex/config.toml (ou .codex/config.toml no projeto):

toml
[mcp_servers.zihin]command = "npx"args = ["-y", "@zihin/mcp-server"]env_vars = ["ZIHIN_API_KEY"]

A variavel ZIHIN_API_KEY deve estar definida no seu shell. Alternativamente, para definir inline:

toml
[mcp_servers.zihin]command = "npx"args = ["-y", "@zihin/mcp-server"]
[mcp_servers.zihin.env]ZIHIN_API_KEY = "zhn_live_xxx"

Outros clientes MCP

Qualquer cliente que suporte o protocolo MCP via stdio pode usar este pacote. O padrao de configuracao e o mesmo: executar npx -y @zihin/mcp-server com a variavel ZIHIN_API_KEY definida.

Variaveis de ambiente

VariavelObrigatoriaDescricao
ZIHIN_API_KEYSimAPI Key do tenant (formato zhn_live_*, zhn_test_* ou zhn_dev_*)
ZIHIN_MCP_URLNaoURL do MCP Server (default: https://llm.zihin.ai/mcp)
ZIHIN_MCP_CALL_TIMEOUT_MSNaoTeto de tempo de um tools/call, em milissegundos (default: 300000, 5 min; faixa aceita: 1000–1800000). O server tem deadline proprio por canal (defaults de chat 150s, builder 180s e demais canais 240s, sujeitos ao teto operacional do servidor) — o default deixa o server responder o erro diagnosticavel antes de o proxy cortar. As skills do backend 2026.10.5 informam teto operacional de 180s para os canais externos, incluindo chat_with_agent; esse valor depende da configuracao do servidor. Acima de ~300s o fetch do Node (undici) pode cortar antes, com timeout proprio de headers/body.

Como funciona

O pacote atua como um proxy transparente entre o cliente MCP local (via stdio) e o Zihin MCP Server (via HTTP):

  • Todas as tools, resources e prompts sao descobertos automaticamente do server
  • Auth, RBAC e tenant isolation sao enforced server-side via API Key
  • O role (admin/editor/member) e determinado pela API Key

Skills — deixe seu IDE especialista no Zihin

O servidor expoe 6 skills (playbooks procedurais: criar agente, tools, triggers, diagnostico, governanca) como resources zihin://skills/*, para os roles que enxergam resources (ver Capabilities). Nada precisa ser instalado, mas o corpo da skill nao e entregue sozinho: o client (ou o modelo) precisa consulta-lo com resources/read.

Para instalar tambem no formato NATIVO do seu client (ativacao automatica por contexto):

bash
# Claude Code (Agent Skills em .claude/skills/)ZIHIN_API_KEY=zhn_live_xxx npx @zihin/mcp-server install-skills --client claude
# Cursor (.cursor/rules/*.mdc) | Windsurf (.windsurf/rules/) | Codex (AGENTS.md + .zihin/skills/)ZIHIN_API_KEY=zhn_live_xxx npx @zihin/mcp-server install-skills --client cursorZIHIN_API_KEY=zhn_live_xxx npx @zihin/mcp-server install-skills --client all
# Offline (usa as skills empacotadas no npm)npx @zihin/mcp-server install-skills --client claude --bundled

Opcoes: --client claude|cursor|windsurf|codex|all · --dir <raiz-do-projeto> · --global (so claude, instala em ~/.claude/skills) · --bundled (offline).

As skills sao buscadas do server vivo (sempre atualizadas). Se a busca falhar (rede, server fora do ar, key recusada) ou voltar vazia, o comando instala as copias empacotadas no npm — as mesmas do --bundled, congeladas na data da release. Na falha ele imprime um aviso; nos dois casos a saida informa a fonte usada (fonte: server ou fonte: bundled). Sem ZIHIN_API_KEY e sem --bundled nao ha fallback: o comando encerra com erro. No Codex, um bloco gerenciado e inserido no AGENTS.md (entre <!-- zihin-skills:start/end -->, idempotente) com o indice das skills em .zihin/skills/.

Plugin Claude Code (MCP + skills em um comando)

bash
claude plugin marketplace add zihin-ai/zihin-mcpclaude plugin install zihin@zihin

O plugin instala o MCP server (via este pacote) + as 6 skills. Requer ZIHIN_API_KEY exportada no ambiente.

Capabilities

As capabilities disponiveis dependem do role da API Key, controlado server-side:

RoleToolsResourcesPrompts
adminTodas (88)193
editorLeitura (48 — writes nao sao listadas)193
memberSubset consumer (5)--

Contagens verificadas contra producao em 04/10/2026 (88 tools / 19 resources — 3 catalogos + 10 schemas + 6 skills / 3 prompts). O numero exato pode variar conforme o server evolui.

Resources disponiveis

URIDescricao
zihin://agentsLista de agentes do tenant
zihin://modelsCatalogo de modelos LLM disponiveis
zihin://schema-templatesTemplates de schema para configuracao
zihin://schemas/{tipo}Contrato formal (JSON Schema) de cada payload — o mesmo que o server valida (10 tipos)
zihin://skills/{slug}Playbooks procedurais (6 skills — ver secao Skills acima)

Prompts disponiveis

NomeDescricao
setup-agentCria um agente completo (agente + persona + tools + publicacao)
add-toolAdiciona uma tool a um agente existente
configure-webhookConfigura trigger webhook para um agente

Testes

87 testes: unitarios offline (classificacao de erros, teto de timeout, install-skills, verificador do registry, coerencia dos manifests do plugin) + integracao real contra o server de producao. Sem ZIHIN_API_KEY, so os offline rodam; com a key, a suite completa:

bash
ZIHIN_API_KEY=zhn_live_xxx npm test

Cobertura: validacao de API Key, tools (incluindo chat_with_agent com session tracking, continuidade e o contrato de saida — execution_id, cancelled, tools_used/tool_calls), resources, prompts, protocolo MCP (identidade espelhada + instructions), classificacao de erros (formas SDK v1 e v2) e o teto de tools/call conferido contra o deadline do server.

A suite de integracao faz DUAS chamadas reais a chat_with_agent (abertura da sessao e continuidade) — dois turnos de agente, com custo real de LLM no tenant. No CI ela roda apenas no workflow da tag v*.

Troubleshooting

"ERRO: ZIHIN_API_KEY nao definida"

Defina a variavel de ambiente antes de rodar:

bash
# macOS / LinuxZIHIN_API_KEY=zhn_live_xxx npx @zihin/mcp-server
# Windows (PowerShell)$env:ZIHIN_API_KEY="zhn_live_xxx"; npx @zihin/mcp-server

"Falha ao conectar ao server"

  • Verifique sua conexao com a internet
  • Verifique se a API Key e valida e esta ativa
  • Se usar URL customizada, verifique ZIHIN_MCP_URL

"ERRO FATAL: API Key invalida ou revogada"

A API Key foi revogada ou desativada no painel Zihin. Gere uma nova key e atualize a configuracao do cliente MCP. Reinicie o processo apos a troca.

"A tool X passou do teto de 300s do proxy e foi abortada"

O proxy espera ate 5 minutos por um tools/call. Quando essa mensagem aparece, o limite atingido foi o do proxy, nao o do server — o trabalho foi cancelado no servidor (no dialeto 2026-07-28 o abort do request e o sinal de cancelamento), entao nao ha execucao orfa queimando token.

  • Turno de agente legitimamente longo: suba o teto com ZIHIN_MCP_CALL_TIMEOUT_MS (em milissegundos, faixa 1000–1800000). Acima de ~300s o proprio fetch do Node pode cortar antes.
  • Quem estourou primeiro foi o server (deadline por canal: defaults de chat 150s, builder 180s e demais canais 240s, sujeitos ao teto operacional do servidor): a mensagem que chega e outra, um erro TURN_TIMEOUT com execution_id e session_id — leve esses dois identificadores para o suporte, sao a correlacao com a execucao no servidor.
  • Cliente MCP tem timeout proprio, independente deste: se o host desistir antes, ele mostra o erro dele.

Tools nao aparecem no cliente

  • Reinicie o cliente MCP apos alterar a configuracao
  • Claude Desktop: verifique logs em ~/Library/Logs/Claude/mcp*.log (macOS) ou %APPDATA%\Claude\logs\mcp*.log (Windows)

Limitacoes

  • Turno longo tem teto: tools/call espera no maximo 5 min no proxy (configuravel — ver ZIHIN_MCP_CALL_TIMEOUT_MS), e o server tem deadline proprio por canal (defaults de chat 150s, builder 180s e demais canais 240s, sujeitos ao teto operacional do servidor). Turno que passa disso e cancelado, nao enfileirado.
  • Streaming: A tool chat_with_agent retorna a resposta completa de uma vez (sincrono). O protocolo MCP define que tools retornam um CallToolResult completo — nao ha suporte a streaming progressivo. Para feedback em tempo real durante execucao do agente, use o endpoint REST SSE (POST /api/v2/agents/:agent_id/stream).

Requisitos

  • Node.js >= 20
  • Compativel com macOS, Linux e Windows

Licenca

MIT

来源：README.md，提交 894373c

工具

0
该服务器需要 API 密钥等凭据，因此 SourceWeft 无法在没有凭据的情况下读取其工具，也未收录。

版本历史

2
  1. v2.2.2最新Oct 5, 2026
  2. v2.2.1Sep 16, 2026

评分

已满足适用检查项的 85%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分