Zihin

Name: Zihin
Author: zihin-ai

제작자: 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의 세 기둥

이 세 가지는 절대 하나의 점수로 합치지 않아요. 의견, 측정, 인기는 서로 다른 것이니까요.

사용자 의견i아직 리뷰가 없어요리뷰는 다음 단계에서 계정 기능과 함께 열려요
우리의 기본 점검i1개 중 1개 통과공개된 정보로 점검했으며, 코드는 아직 스캔하지 않았어요
사용 정도i아직 측정 안 함★ –

할 수 있는 일

이 서버는 아직 쉬운 말로 된 요약을 쓰지 못했어요. 아래는 레지스트리에서 읽어 온 사실이에요.

연결 방식: 컴퓨터 또는 클라우드
전송 방식: stdio, Streamable HTTP
카테고리: 채팅 및 이메일
입력해야 할 값: ZIHIN_API_KEY, X-Api-Key

설치

쓰고 있는 AI 앱을 고른 다음 설정을 복사하세요.

설치하기 전에

기본 점검: 1개 중 1개 통과
제작자의 서버에서 실행돼요. 내가 요청한 내용은 제작자의 서버를 거쳐요.
직접 입력할 값: ZIHIN_API_KEY, X-Api-Key

비밀로 표시된 값은 내 계정의 열쇠예요. 절대 다른 사람과 공유하거나 채팅에 붙여 넣지 마세요.

필요한 것

클라우드에서 실행설치할 것 없음. 인터넷으로 연결돼요
npmNode.js 설치(npx 명령어용)

어떤 앱을 쓰세요?

ClaudeClaude CodeCursorVS CodeChatGPT

위에서 앱을 고르세요. 기억해 두었다가 다음부터는 버튼에 “…에 설치”라고 표시해요.

이 주소는 요청 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를 쓰세요.

선택한 앱은 이 기기의 쿠키에만 저장돼요. 계정은 필요 없어요.

직접 입력할 값

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

이 카테고리의 다른 서버 1772개 중 0%보다 스타가 많아요
이 카테고리의 다른 서버 1772개 중 45%보다 최근에 레지스트리에 공개됐어요
기본 점검 결과가 이 카테고리의 다른 서버 1772개 중 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 스타i세 기둥: 리뷰 · 점검 · 사용 정도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

Gere uma API Key no console da Zihin.
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.

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

Variavel	Obrigatoria	Descricao
`ZIHIN_API_KEY`	Sim	API Key do tenant (formato `zhn_live_`, `zhn_test_` ou `zhn_dev_*`)
`ZIHIN_MCP_URL`	Nao	URL do MCP Server (default: `https://llm.zihin.ai/mcp`)
`ZIHIN_MCP_CALL_TIMEOUT_MS`	Nao	Teto 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:

Role	Tools	Resources	Prompts
`admin`	Todas (88)	19	3
`editor`	Leitura (48 — writes nao sao listadas)	19	3
`member`	Subset 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

URI	Descricao
`zihin://agents`	Lista de agentes do tenant
`zihin://models`	Catalogo de modelos LLM disponiveis
`zihin://schema-templates`	Templates 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

Nome	Descricao
`setup-agent`	Cria um agente completo (agente + persona + tools + publicacao)
`add-tool`	Adiciona uma tool a um agente existente
`configure-webhook`	Configura 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

앞부분만 보여 드려요. 나머지는 저장소에서 읽어 보세요

Zihin

개요

PopNx MCP의 세 기둥

할 수 있는 일

설치

설치하기 전에

또는 내 컴퓨터에서 실행하기

또는 내 컴퓨터에서 실행하기

또는 내 컴퓨터에서 실행하기

또는 내 컴퓨터에서 실행하기

직접 입력할 값

할 수 있는 일

기본 점검i

제작자와 저장소 일치

계속 관리되고 있음

라이선스 있음

엔드포인트 응답

OAuth로 로그인

도구 설명에 숨겨진 지시 없음

채팅 및 이메일 카테고리의 다른 서버와 비교i

자주 묻는 질문

대안

Vexa

emailmd

MCP WhatsApp Cloud

제작자의 README

@zihin/mcp-server

Em 30 segundos

O que você pode fazer

Inicio rapido

Configuracao

Claude Desktop

Claude Code

Cursor

VS Code (Copilot)

Windsurf

Gemini CLI

Codex (OpenAI)

Outros clientes MCP

Variaveis de ambiente

Como funciona

Skills — deixe seu IDE especialista no Zihin

Cursor (.cursor/rules/*.mdc) | Windsurf (.windsurf/rules/) | Codex (AGENTS.md + .zihin/skills/)

Offline (usa as skills empacotadas no npm)

Plugin Claude Code (MCP + skills em um comando)

Capabilities

Resources disponiveis

Prompts disponiveis

Testes

Troubleshooting

"ERRO: ZIHIN_API_KEY nao definida"

Windows (PowerShell)

"Falha ao conectar ao server"

"ERRO FATAL: API Key invalida ou revogada"