World Monitor
Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.
Annotate screenshots in the Snipaya macOS app: arrows, text, redaction, crop, export
一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり
| 人気 | 0/80 | GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます |
|---|---|---|
| 新しさ | 12/12 | 30 日以内のリリースかコード更新で満点 |
| 応答中 | 0/8 | 前回の確認でクラウドのエンドポイントが応答 |
| 利用スコア | 12/100 |
品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)
使っているAIアプリを選んで、設定をコピーしてください。
ひとことで AI にインストールしてもらう
Snipaya をインストールして。https://mcp.popnx.com/i/krzysztofsurdy-snipaya-mcp.md に従い、コマンドを見せて、私が OK するまで実行しないで。パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る
チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月14日
まず:どの AI を使っていますか?
使っているアプリを選ぶと、下に手順が表示されます。
Claude につなげますが、先に準備が必要です
Snipaya のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
このメッセージを Claude のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Claude に MCP server Snipaya を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "snipaya": { "command": "npx", "args": [ "-y", "snipaya-mcp" ], "env": { "SNIPAYA_MCP_TOKEN": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) SNIPAYA_MCP_TOKEN は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、Snipaya のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
node -vMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v
一度入れれば、Node.js を使うすべてのツールで使えます
SettingsDeveloperEdit Config
{
"mcpServers": {
"snipaya": {
"command": "npx",
"args": [
"-y",
"snipaya-mcp"
],
"env": {
"SNIPAYA_MCP_TOKEN": "your-value"
}
}
}
}キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
Snipaya を使って、私に何ができるか教えて、1 つやってみせて✓ Claude が Snipaya を使っていると言うか、回答に Snipaya のツール名が出れば接続成功です
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
SNIPAYA_MCP_URL MCP URL from Snipaya > Settings > AI Assistants. Uses the port Snipaya saved when unsetSNIPAYA_MCP_NO_LAUNCH 1 に設定すると、Snipaya が実行されていないときに開かなくなります 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
ChatGPT はまだ Snipaya につなげません
Snipaya はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません
A · Snipaya につなげるアプリを使う
B · その他 の中で ChatGPT につなげる別のサーバー
同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました
Claude Code につなげますが、先に準備が必要です
Snipaya のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Node.js を入れてください(1 回だけ)
このメッセージを Claude Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Claude Code に MCP server Snipaya を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):claude mcp add --scope user snipaya --env SNIPAYA_MCP_TOKEN=your-value -- npx -y snipaya-mcp 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) SNIPAYA_MCP_TOKEN は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、Snipaya のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
node -vMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v
一度入れれば、Node.js を使うすべてのツールで使えます
Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く
claude mcp add --scope user snipaya --env SNIPAYA_MCP_TOKEN=your-value -- npx -y snipaya-mcpEnter の前に「your-value」を自分のキーに書き換えてください
キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
Snipaya が一覧にあり、接続済みと表示されれば OK です
Snipaya を使って、私に何ができるか教えて、1 つやってみせて✓ Claude Code が Snipaya を使っていると言うか、回答に Snipaya のツール名が出れば接続成功です
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
SNIPAYA_MCP_URL MCP URL from Snipaya > Settings > AI Assistants. Uses the port Snipaya saved when unsetSNIPAYA_MCP_NO_LAUNCH 1 に設定すると、Snipaya が実行されていないときに開かなくなります 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Cursor につなげますが、先に準備が必要です
Snipaya のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Node.js を入れてください(1 回だけ)
このメッセージを Cursor のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Cursor に MCP server Snipaya を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "snipaya": { "command": "npx", "args": [ "-y", "snipaya-mcp" ], "env": { "SNIPAYA_MCP_TOKEN": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) SNIPAYA_MCP_TOKEN は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、Snipaya のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
node -vMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v
一度入れれば、Node.js を使うすべてのツールで使えます
Snipaya の設定で SNIPAYA_MCP_TOKEN が空です。自分のキーを入れて保存します
キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
Snipaya を使って、私に何ができるか教えて、1 つやってみせて✓ Cursor が Snipaya を使っていると言うか、回答に Snipaya のツール名が出れば接続成功です
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
SNIPAYA_MCP_URL MCP URL from Snipaya > Settings > AI Assistants. Uses the port Snipaya saved when unsetSNIPAYA_MCP_NO_LAUNCH 1 に設定すると、Snipaya が実行されていないときに開かなくなります 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
VS Code につなげますが、先に準備が必要です
Snipaya のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Node.js を入れてください(1 回だけ)
このメッセージを VS Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの VS Code に MCP server Snipaya を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "servers": { "snipaya": { "type": "stdio", "command": "npx", "args": [ "-y", "snipaya-mcp" ], "env": { "SNIPAYA_MCP_TOKEN": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) SNIPAYA_MCP_TOKEN は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、Snipaya のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
node -vMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v
一度入れれば、Node.js を使うすべてのツールで使えます
Snipaya の設定で SNIPAYA_MCP_TOKEN が空です。自分のキーを入れて保存します
キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
Snipaya を使って、私に何ができるか教えて、1 つやってみせて✓ VS Code が Snipaya を使っていると言うか、回答に Snipaya のツール名が出れば接続成功です
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
SNIPAYA_MCP_URL MCP URL from Snipaya > Settings > AI Assistants. Uses the port Snipaya saved when unsetSNIPAYA_MCP_NO_LAUNCH 1 に設定すると、Snipaya が実行されていないときに開かなくなります 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Claude Code
claude mcp add --scope user snipaya --env SNIPAYA_MCP_TOKEN=your-value -- npx -y snipaya-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"snipaya": {
"command": "npx",
"args": [
"-y",
"snipaya-mcp"
],
"env": {
"SNIPAYA_MCP_TOKEN": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"snipaya": {
"command": "npx",
"args": [
"-y",
"snipaya-mcp"
],
"env": {
"SNIPAYA_MCP_TOKEN": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"snipaya": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"snipaya-mcp"
],
"env": {
"SNIPAYA_MCP_TOKEN": "your-value"
}
}
}
}SNIPAYA_MCP_TOKEN 秘密 必須 envSNIPAYA_MCP_URL envSNIPAYA_MCP_NO_LAUNCH env説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。
npm: snipaya-mcpこのサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。
パソコン上で動かせるアプリ
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。
誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月20日にチェック
レジストリ名は、リポジトリを所有するGitHubアカウント krzysztofsurdy で確認済みです
コードの最終更新:15 日前
MITを使用
これはパソコンで動くため、インターネット上のエンドポイントはありません
パソコンで動き、代わりにローカルの設定を使います
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです
OSV.dev に snipaya-mcp@1.2.2 の登録はありません
このバージョンのパッケージ本体のみ確認。すべての依存関係ではありません · 確認日 2026年11月15日
作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。
[](https://mcp.popnx.com/en/servers/krzysztofsurdy-snipaya-mcp)質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。
まだレビューはありません
レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。
当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。
入力が必要なもの:SNIPAYA_MCP_TOKEN
あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。
GitHubリポジトリの最終更新は15 日前、最新バージョン(1.2.2)がレジストリに届いたのは27 日前です。
Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。
同じカテゴリには:World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu
同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。
カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i
Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.
Manage monitors, status pages, incidents and maintenances in your openstatus workspace.
Validate oh-my-posh configurations and segment snippets against the official schema.
MCP server for progressive tool usage at any scale (see https://klavis.ai)
Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.
| これ Snipaya | World Monitor | openstatus | Oh My Posh Validator | Strata | Jitsu | |
|---|---|---|---|---|---|---|
| 動く場所 | パソコンにインストールが必要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 |
| キーが必要 | はい | いいえ | いいえ | いいえ | いいえ | いいえ |
| Claude で + から追加 | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ |
| 基本チェック | 3/3 | 4/4 | 4/4 | 4/4 | 1/4 | 4/4 |
| ライセンス | MIT | AGPL-3.0 | AGPL-3.0 | MIT | Apache-2.0 | MIT |
| 料金 | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし |
作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。
snipaya-mcp
Connect any MCP client that speaks stdio to Snipaya, the image and screenshot annotator for macOS. Your assistant can read the canvas, add arrows, text, shapes and callouts, redact sensitive data, crop, and export, while you watch the result in Snipaya.
Snipaya has an MCP server built in, served over Streamable HTTP on 127.0.0.1. snipaya-mcp is a thin bridge for clients that only start local stdio servers: it forwards every MCP message between the client and Snipaya, unchanged.
Tools and prompts are listed even before Snipaya is open. Until Snipaya answers, the bridge lists them from a built-in catalog, and a tool call returns a message that says what to do.
Listed on the MCP Registry as io.github.krzysztofsurdy/snipaya-mcp, on Glama and in TensorBlock awesome-mcp-servers.
npx setup).The server is off by default.
That is all the bridge needs. It reads the access token and port from the settings Snipaya saves on this Mac, so you do not have to copy them.
npx -y snipaya-mcp
If Snipaya is not running but Allow AI assistants is on, the bridge opens Snipaya in the background and waits up to 10 seconds for its server.
To override what Snipaya saved, set these variables or flags. Flags win over variables, and variables win over the saved settings.
| Variable | Flag | Default | |
|---|---|---|---|
SNIPAYA_MCP_TOKEN | --token | Token Snipaya saved | Access token from Settings > AI Assistants. |
SNIPAYA_MCP_URL | --url | http://127.0.0.1: /mcp, else http://127.0.0.1:47321/mcp | Server URL from Snipaya. Only 127.0.0.1 and localhost are accepted. |
SNIPAYA_MCP_NO_LAUNCH | Set to 1 to never open Snipaya. While Snipaya is closed, tool calls then return Cannot reach Snipaya. |
Prefer the environment variable over --token: command-line flags are visible to other processes on the Mac.
For clients configured with an mcpServers JSON file:
{
"mcpServers": { "snipaya": { "command": "npx", "args": ["-y", "snipaya-mcp"], "env": { "npm_config_registry": "https://registry.npmjs.org/" } } } }
For a custom setup, pass the values in env instead:
{
"mcpServers": { "snipaya": { "command": "npx", "args": ["-y", "snipaya-mcp"], "env": { "npm_config_registry": "https://registry.npmjs.org/", "SNIPAYA_MCP_TOKEN": " ", "SNIPAYA_MCP_URL": " " } } } }
If your client supports Streamable HTTP servers directly, you do not need this bridge: use Copy MCP config in Snipaya instead.
snipaya-mcp- .mcpb from the latest release.127.0.0.1 and accepts only loopback Host headers and requests without an Origin header, so websites in your browser cannot reach it. The bridge refuses any URL whose host is not 127.0.0.1 or localhost, and never sends an Origin header.Authorization: Bearer . Snipaya generates the token, and Regenerate in Settings revokes the old one. The bridge never writes the token to its logs.SNIPAYA_MCP_TOKEN, the bridge reads the token and port from ~/Library/Application Support/Snipaya/mcp.json, which Snipaya writes readable only by your macOS user. The bridge never writes to it.open -g -b dev.snipaya.app (no shell) and retries. It does this at start, and again for a tool call while Snipaya is not reachable. Any other failure, such as a rejected token, never opens the app. SNIPAYA_MCP_NO_LAUNCH=1 turns this off.The tools come from the Snipaya version you have installed. Until Snipaya answers, the bridge lists the tools of Snipaya 1.3.3 from its catalog, and once Snipaya answers, the list of your installed version applies. Snipaya 1.3 provides:
| Tool | Title |
|---|---|
snipaya_get_canvas | Get canvas |
snipaya_render | Render canvas |
snipaya_add_image | Add image |
snipaya_add_arrow | Add arrow or line |
snipaya_add_shape | Add shape |
snipaya_add_text | Add text |
snipaya_add_step | Add step number |
snipaya_add_emoji | Add emoji |
snipaya_add_freehand | Add freehand stroke |
snipaya_add_magnifier | Add magnifier |
snipaya_add_callout | Add callout |
snipaya_add_spotlight | Add spotlight |
snipaya_add_measure | Add measurement |
snipaya_pick_color | Pick color |
snipaya_read_text | Read text |
snipaya_redact | Redact sensitive data |
snipaya_update_items | Update elements |
snipaya_delete_items | Delete elements |
snipaya_select | Select elements |
snipaya_arrange | Arrange images |
snipaya_set_crop | Set crop |
snipaya_undo | Undo |
snipaya_redo | Redo |
snipaya_tabs | Manage tabs |
snipaya_export | Export image |
snipaya_list_destinations | List export destinations |
snipaya_export_to | Export to destination |
snipaya_save_project | Save project |
| Prompt | Title | Optional argument |
|---|---|---|
explain_bug | Explain a bug in a screenshot | issue |
redact_before_sharing | Redact secrets before sharing | also_hide |
finish_screenshot | Make a screenshot look finished | background |
copy_text | Copy text out of an image | area |
make_walkthrough | Turn screenshots into a walkthrough | topic |
compare_before_after | Compare before and after | change |
The bridge writes the problem to stderr (never stdout, which carries the protocol). While Snipaya is not reachable, it still lists the tools, and returns the same text as the result of each tool call. When Snipaya starts answering, for example after you open it or accept the license agreement, the next tool call reaches it without a restart.
| Message | Fix |
|---|---|
Snipaya's settings were not found | Install Snipaya, open it once and turn on Allow AI assistants. Or set SNIPAYA_MCP_TOKEN. |
Snipaya is a macOS app | The bridge runs on another system. It lists the tools, but they work only with Snipaya on a Mac. |
Snipaya's MCP server is off | Turn on Allow AI assistants in Settings > AI Assistants. |
Snipaya's settings ... cannot be read or hold no valid token | Open Snipaya, which rewrites its settings, then check Allow AI assistants. Or set SNIPAYA_MCP_TOKEN. |
Cannot open Snipaya | Snipaya is not installed in a place macOS can find. Install it from snipaya.app or open it yourself. |
Opened Snipaya, but its MCP server starts only after you accept the license agreement | Snipaya 1.1 and newer start the MCP server only after you accept the license agreement. Accept it in the Snipaya window, then call the tool again. |
Opened Snipaya, but its MCP server did not answer | Open Settings > AI Assistants and fix the error shown under the status. |
Cannot reach Snipaya at ... | Open Snipaya and turn on Allow AI assistants. If the message mentions the license agreement, accept it in Snipaya first. If the status shows an error, fix that first. Check that the URL matches Server URL. |
Snipaya rejected the token | The token changed, for example after Regenerate. Remove SNIPAYA_MCP_TOKEN to use the saved token, or copy the current one. |
Snipaya ended the session | Snipaya restarted or the token changed. Restart the snipaya server in your client. |
Refusing | The URL must point to 127.0.0.1 or localhost. Copy Server URL from Snipaya. |
CONNECTION_CLOSED or Failed to connect, with npm error 404 ... is not in this registry in the MCP log | The bridge never started: a project .npmrc points npm at a private registry, and MCP clients start the server in the project folder. Set npm_config_registry to https://registry.npmjs.org/ for the snipaya server, in env as in the JSON config above. In Claude Code, add the server once for every project with claude mcp add --scope user snipaya -e npm_config_registry=https://registry.npmjs.org/ -- npx -y snipaya-mcp. Claude Code keeps MCP server logs in ~/Library/Caches/claude-cli-nodejs/ /mcp-logs-snipaya/. |
Run npx -y snipaya-mcp --help to see the options.
npm ci
npm run lint npm run typecheck npm test # builds, then runs the bridge over stdio against a local test server npm run pack:mcpb # builds snipaya-mcp- .mcpb with the official mcpb CLI
catalog.json holds the tools, prompts and instructions the bridge serves while Snipaya is not reachable, and manifest.json lists the same tools and prompts. Regenerate both from a checkout of the Snipaya app (default ../snipaya) with Node 22.6 or newer, and commit the result:
npm run sync:catalog -- ../snipaya
Without a token or URL, the bridge reads the settings of the installed Snipaya in ~/Library/Application Support/Snipaya. Development builds of Snipaya keep their settings in their own Snipaya Dev profile folder, so to bridge to one, set SNIPAYA_MCP_TOKEN and SNIPAYA_MCP_URL to the values shown in