Snipzr

Snipzr MCP サーバー

公式のSnipzr MCP サーバーです。1 つのホスト型エンドポイントを使うと、どの MCP クライアントからでも 13 個のツールを利用して、ブランドドメイン、バッチ作成、Cookie を使わない分析、キャンペーンレポート、UTM の作成、QR コードなど、短縮リンクの作成、管理、測定ができます。

https://mcp.snipzr.com/mcp

インストールや実行は不要です。このサーバーはリモート（Streamable HTTP）で、ステートレスです。クライアントが OAuth でサインインすれば、Free を含むすべての Snipzr プランで利用できます。ブラウザーを使わないクライアントでベアラートークンを使うには、有料プランが必要です。このリポジトリは公開ホームで、セットアップ方法、ツールのリファレンス、レジストリのメタデータを掲載しています。サーバー自体は Snipzr プラットフォームの一部であり、そのツールは公開 REST APIと同じハンドラーを薄くラップしているため、どちらのインターフェースでも常に同じ動作をします。

クイックスタート

1. サインインして接続します（推奨）。 ほとんどのクライアントでは、トークンは必要ありません。サーバーアドレスを指定すると、Snipzr のサインイン画面が開きます。同意画面には、アプリケーションが取得する権限と、操作できるワークスペースが正確に表示されます。許可したくない項目のチェックを外し、後から設定で接続を解除できます。

Claude Code の場合は、次の 2 つのコマンドを実行します。

claude mcp add --transport http snipzr https://mcp.snipzr.com/mcp
claude mcp login snipzr

Claude のウェブ版、デスクトップ版、モバイル版では、設定を開き、「コネクタ」、「カスタムコネクタを追加」の順に選択し、サーバーアドレスを入力して「接続」を選択します。ChatGPT も開発者モードで同じ方法で接続できます。Smithery、Glama などのディレクトリも、同じサインイン方法で接続します。

2. トークンを使用することもできます。 設定でトークンを作成し、シークレットをコピーします（シークレットは一度だけ表示されます）。

• ユーザー API トークンは、あなたとして操作します。トークンが操作できるワークスペースと、各ワークスペースで実行できる操作を選択してください。
• ワークスペース API トークンは 1 つのワークスペースに属し、そのワークスペースとして操作します。チームで共有するアシスタントや、ブラウザーを使わないクライアントに適しています。

Cursor、VS Code、その他の MCP クライアントでは、汎用のリモート設定を使用します。

{
  "mcpServers": {
    "snipzr": {
      "url": "https://mcp.snipzr.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

stdio のみを話すクライアントは、npx mcp-remote https://mcp.snipzr.com/mcp --header "Authorization: Bearer YOUR_TOKEN" でブリッジできます。

3. 接続を確認します。 アシスタントに Snipzr のツールを一覧表示するよう依頼してください。snipzr_ で始まる名前が 13 個表示されれば、接続できています。

13 個のツール

ツール	機能	スコープ
snipzr_create_link	短縮リンクを 1 つ作成します。宛先、任意のドメイン、末尾部分、タイトルを指定できます	links:write
snipzr_create_links_batch	1 回の呼び出しで最大 100 個の短縮リンクを作成します	links:write
snipzr_list_links	テキスト、ドメイン、キャンペーンの各フィルターでリンクを一覧表示します	links:read
snipzr_get_link	末尾部分を指定してリンクを 1 つ読み取ります	links:read
snipzr_update_link	宛先またはタイトルを変更します	links:write
snipzr_delete_link	確認ステップを挟んでリンクを削除します	links:write
snipzr_get_link_stats	日別のクリック数とスキャン数を表示します。ボット、AI アシスタント、疑わしい自動トラフィックはそれぞれ別に集計されます	stats:read
snipzr_get_campaign_report	キャンペーン別に集計したクリック数を表示します	stats:read
snipzr_get_usage	プラン、残りの利用枠、リセット日を表示します	usage:read
snipzr_list_domains	短縮ドメインとそのステータスを表示します	domains:read
snipzr_get_qr_code	色、キャプション、ロゴを指定できる、読み取り可能な QR コード（PNG、JPEG、SVG）と署名付きダウンロード URL を取得します	links:read
snipzr_build_utm_link	ワークスペースの規則に従った UTM リンクを作成します	links:read
snipzr_list_workspaces	この接続で操作できるワークスペースと、workspaceId として渡す ID を表示します	任意

各ツールには読み取り専用または破壊的操作の注釈が付いているため、適切なクライアントは削除の前には確認を求めますが、読み取りの前には求めません。また、各ツールは出力スキーマを公開し、テキストに加えて構造化コンテンツを返すため、エージェントは文章を解析するのではなく、フィールドを読み取れます。

アクセスモデル

• スコープを使うと、トークンの権限を必要なものだけに絞れます：links:read、links:write、stats:read、usage:read、domains:read。トークンのスコープ外の呼び出しは、不足しているスコープを示すメッセージとともに拒否されます。
• 接続は、選択したワークスペースで動作します。 サインイン接続では、同意画面でチェックしたワークスペースのみを利用できます。ユーザートークンでは、作成時に選択したワークスペースを利用できます。デフォルトは個人用ワークスペースです。付与された別のワークスペースで作業するには、アシスタントが任意のツールのworkspaceId引数としてその ID を渡します（snipzr_list_workspacesで一覧を確認できます）。アクセス権はそのワークスペースでの現在のメンバーシップに従い、毎回の呼び出し時に確認されます。ワークスペースを離れるとトークンは即座にアクセス権を失い、再追加されると新しいロールでアクセスが再開されます。
• ワークスペーストークンは、対応する 1 つのワークスペースでのみ利用でき、それ以外のワークスペースでは拒否されます。個人には紐づいていないため、人が入れ替わっても自動化は引き続き動作します。
• 拒否時には安定したコード（SCOPE_REQUIRED、NOT_GRANTED、GRANT_INACTIVE、GRANT_REDUCED、PLAN_REQUIRED）が返されるため、エージェントは理由を説明し、自ら修正できます。

知っておくと便利なこと

• エージェントが作成するリンクは、手動で作成するリンクと同じ月間利用枠にカウントされ、リクエストはプランの API レート制限を共有します。一括処理の前に、snipzr_get_usageで両方を確認できます。
• QR コードはインライン画像と有効期間の短い署名付きダウンロード URL として返されるため、エージェントは画像データをモデル経由で送ることなくファイルを保存できます。
• Settings でトークンを取り消すか、アプリケーションを切断すると、クライアントは即座にアクセスできなくなります。また、切断されたアプリケーションがひそかに再接続することはできず、再度ユーザーに許可を求める必要があります。
• サーバーはリンク先をログに記録せず、アナリティクスは Cookie を使用しません。

リンク

• クライアントごとの詳細を含むセットアップ：snipzr.com/integrations/mcp
• ドキュメントガイド：AI を MCP に接続する
• REST API リファレンス：snipzr.com/docs/api

サポート

質問や問題の報告は、このリポジトリの Issues または [email protected] で受け付けています。トークンシークレットは絶対に投稿しないでください。漏えいした場合は、まず Settings で取り消すか、ローテーションしてください。