プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。レビューとアカウント機能は今後のステップで始まります。
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説

Zihin

作者:zihin-aiバージョン 2.2.2i★ –iパソコンでもクラウドでも
レジストリ名ai.zihin/mcp-server

インストール

概要

作者による説明(英語の原文)

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

PopNx MCPの3つの柱

この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。

できること

このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。

  • 接続方法: パソコンでもクラウドでも
  • トランスポート: stdio, Streamable HTTP
  • カテゴリ: チャット・メール
  • 入力が必要なもの:ZIHIN_API_KEY, X-Api-Key

インストール

使っているAIアプリを選んで、設定をコピーしてください。

インストールの前に

「秘密」と表示された値は、あなたのアカウントの鍵です。絶対に人に教えたり、チャットに貼り付けたりしないでください。

必要なもの

  • クラウドで動くインストール不要。インターネット経由でつながります
  • npmNode.jsのインストール(npxコマンドに必要)

どのアプリを使っていますか?

上でアプリを選んでください。選んだアプリを覚えておくので、次からはボタンに「…にインストール」と表示されます。

このアドレスはリクエストの header にキーが必要ですが、コネクタを追加するメニューでは設定できません。代わりにClaude Code、Cursor、VS Codeを使ってください。

または、パソコンで動かす

Claude Desktop → Settings → Developer → Edit Config を開き、claude_desktop_config.json にこれを貼り付けます

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

ターミナルでこれを実行します

claude mcp add --transport http zihin https://llm.zihin.ai/mcp --header 'X-Api-Key: your-value'

または、パソコンで動かす

claude mcp add zihin --env ZIHIN_API_KEY=your-value -- npx -y @zihin/mcp-server

動かす前に、空欄の値を入力してください。

Cursorで開く

または、設定を自分でコピーする

プロジェクトの .cursor/mcp.json、または ~/.cursor/mcp.json に貼り付けます

{
  "mcpServers": {
    "zihin": {
      "url": "https://llm.zihin.ai/mcp",
      "headers": {
        "X-Api-Key": "your-value"
      }
    }
  }
}

または、パソコンで動かす

Cursorで開く

または、設定を自分でコピーする

プロジェクトの .cursor/mcp.json、または ~/.cursor/mcp.json に貼り付けます

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

ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。

VS Codeで開く

または、設定を自分でコピーする

プロジェクトの .vscode/mcp.json に貼り付けます

{
  "servers": {
    "zihin": {
      "type": "http",
      "url": "https://llm.zihin.ai/mcp",
      "headers": {
        "X-Api-Key": "your-value"
      }
    }
  }
}

または、パソコンで動かす

VS Codeで開く

または、設定を自分でコピーする

プロジェクトの .vscode/mcp.json に貼り付けます

{
  "servers": {
    "zihin": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@zihin/mcp-server"
      ],
      "env": {
        "ZIHIN_API_KEY": "your-value"
      }
    }
  }
}

ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。

このアドレスはリクエストの header にキーが必要ですが、コネクタを追加するメニューでは設定できません。代わりにClaude Code、Cursor、VS Codeを使ってください。

選んだアプリは、この端末のCookieに保存されます。アカウントは不要です。

自分で入力する値

  • ZIHIN_API_KEY 秘密 必須 env
    Zihin API Key (zhn_live_*, zhn_test_* or zhn_dev_*), from the Zihin console
  • X-Api-Key 秘密 必須 HTTP header
    Zihin API Key (zhn_live_*, zhn_test_* or zhn_dev_*), from the Zihin console

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

できること

このサーバーのツール一覧はまだ読み取っていません。エンドポイントは順番にチェックしています。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月7日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名はドメイン zihin.ai で確認済みです(レジストリがドメインの所有を確認しています)

  • … 未チェック

    今もメンテナンスされている

    このリポジトリはまだGitHubから読み取っていません

  • … 未チェック

    ライセンスがある

    このリポジトリはまだGitHubから読み取っていません

  • … 未チェック

    エンドポイントが応答する

    まだチェックしていません。エンドポイントは順番にチェックしています

  • … 未チェック

    OAuthでサインイン

    まだチェックしていません。エンドポイントは順番にチェックしています

  • … 未チェック

    ツールの説明に隠れた指示がない

    まだチェックしていません。エンドポイントをチェックするときにツール一覧を読み取ります

チャット・メールのほかのサーバーとの比較i

  • このカテゴリのほかの1773件のうち0%よりスターが多い
  • このカテゴリのほかの1773件のうち45%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの1773件のうち100%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Zihinは安全ですか?

当てはまる基本チェック1項目のうち1項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

入力が必要なもの:ZIHIN_API_KEY, X-Api-Key

パソコンで動きますか、それともクラウドですか?

どちらでも使えます。パソコンにインストールしても、クラウド版につないでもかまいません。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は–、最新バージョン(2.2.2)がレジストリに届いたのは33 日前です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。URLでつながるので、リモートMCPサーバーに対応したアプリ(開発者モードのChatGPTなど)でも使えます。

代わりに使えるものは?

同じカテゴリには:Vexa, emailmd, MCP WhatsApp Cloud

代わりの候補

同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。

カードの見方:★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

Vexa

作者:Vexa-ai

Meeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled.

クラウドで動く★ 2,949Apache-2.02 か月前更新
インストール

emailmd

作者:anypost

Render markdown into email-safe HTML, lint drafts for deliverability problems, and preview emails.

パソコンでもクラウドでも★ 1,385MIT31 日前更新
インストール

MCP WhatsApp Cloud

作者:codespar

MCP server for WhatsApp Cloud API (Meta) — messages, media, and templates via Graph API

パソコンで動く★ 277MIT5 か月前更新
インストール

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

@zihin/mcp-server

Converse com seus agentes de IA da [Zihin.ai](https://www.zihin.ai) e gerencie-os direto do seu IDE ou assistente — Claude, Cursor, VS Code, Codex, Gemini CLI ou qualquer cliente MCP.

Se este projeto for útil para você, uma ⭐ ajuda outras pessoas a encontrá-lo.

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

Cliente MCP <-stdio-> [@zihin/mcp-server] <-HTTP-> https://llm.zihin.ai/mcp
Em 30 segundos
  1. Gere uma API Key no console da Zihin.
  2. Registre o servidor no seu cliente — no Claude Code, por exemplo:
   claude mcp add zihin -e ZIHIN_API_KEY=zhn_live_xxx -- npx -y @zihin/mcp-server

Claude Desktop, Cursor (1 clique), VS Code (1 clique), Windsurf, Gemini CLI e Codex: ver Configuracao.

  1. Peça ao assistente: *"liste meus agentes Zihin"* ou *"converse com o agente X"*.
O que você pode fazer
  • Conversar com agentes publicados (chat_with_agent, com continuidade de sessão).
  • Criar e configurar agentes: persona, tools de API externa, MCP servers externos e publicação — com o prompt guiado setup-agent.
  • Conectar canais e automações: triggers de webhook (WhatsApp, Slack, Teams, n8n), agendados e por e-mail.
  • Governar: teto de gasto por agente, políticas de segurança e aprovação humana antes de ações sensíveis.
  • Diagnosticar: métricas por agente, traces de execução e saúde do tenant.

Até 88 tools para uma key admin (ver Capabilities); o que cada key enxerga depende do role. Documentação completa: docs.zihin.ai · Site: www.zihin.ai

Inicio rapido

macOS / Linux:

ZIHIN_API_KEY=zhn_live_xxx npx @zihin/mcp-server

Windows (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:

{

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

Claude Code

Adicione ao .mcp.json do projeto:

{

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

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 ' '):

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:

{

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

VS Code (Copilot)

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:

{

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

Windsurf

Adicione ao ~/.windsurf/mcp.json:

{

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

Gemini CLI
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):

[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:

[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):

# 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 cursor ZIHIN_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 · --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 , idempotente) com o indice das skills em .zihin/skills/.

Plugin Claude Code (MCP + skills em um comando)
claude plugin marketplace add zihin-ai/zihin-mcp

claude 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:

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:

# macOS / Linux

ZIHIN_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. Reini

冒頭だけを表示しています。続きはリポジトリで読めます

PopNxに聞く