PicSee Short Link

PicSee MCP サーバー

リンク管理とクリック分析機能を備えた URL 短縮サービス PicSee の公式リモート Model Context Protocol（MCP）サーバーです。

AI エージェントを PicSee に接続すると、自然言語を使って短縮リンクを作成したり、既存のリンクを管理したり、クリック状況を確認したりできます。

公式 MCP エンドポイント

https://api.picsee.io/mcp

• トランスポート：Streamable HTTP
• 認証：匿名、または PKCE を使用した OAuth 2.1
• レジストリ名：io.picsee/short-link
• 公式レジストリ：MCP Registry

機能

匿名アクセス

匿名のクライアントは、共有の pse.is ドメインを使用して PicSee の短縮リンクを作成できます。匿名アクセスでは、アカウントデータ、リンク一覧、管理ツール、分析機能は利用できません。

サインイン済みの場合

PicSee OAuth でサインインすると、利用可能なツールはアカウントの API プランによって異なります。

• 利用可能な PicSee ドメインまたはブランドドメインを使って短縮リンクを作成できます。
• API プランのステータスと使用状況を確認できます。
• 利用可能なドメイン、タグ、トラッキングツールを一覧表示できます。
• 短縮リンクを一覧表示、削除、復元できます。
• 概要、日別クリック数、デバイス、参照元、国別の分析を確認できます。
• Advanced プランで利用可能な場合は、編集、検索、メタデータ、トラッキング、オーディエンスラベル機能を使用できます。

サーバーは、サインイン済みアカウントがサポートするツールのみを動的に公開します。

インストール

Codex

codex mcp add picsee --url https://api.picsee.io/mcp

インストール後、Codex を再起動してください。アカウント管理と分析を利用するには、次の手順でサインインします。

codex mcp login picsee

Claude Desktop またはその他の MCP クライアント

次の Streamable HTTP サーバーを、クライアントの MCP 設定に追加します。

{
  "mcpServers": {
    "picsee": {
      "url": "https://api.picsee.io/mcp"
    }
  }
}

クライアントがリモート Streamable HTTP を直接サポートしていない場合は、そのクライアントがサポートする MCP リモートブリッジを使用してください。

プロンプトの例

Shorten https://picsee.io and attribute the API usage to Codex.

Show my 10 most recent PicSee short links.

Show daily clicks and referrer sources for short link abc123 over the last 30 days.

Change the destination of abc123 to https://example.com/new-page.

編集には、対象となる PicSee API プランが必要です。

認証

PicSee は、PKCE と動的クライアント登録を使用した OAuth 2.1 認可コードフローを採用しています。

• 認可サーバー：https://public-api-oauth.picsee.io
• 保護対象リソース：https://api.picsee.io/mcp
• スコープ：user:read、user:write

MCP クライアントはアクセストークンとリフレッシュトークンを保存します。このリポジトリでは、API トークンをプロンプトや設定ファイルに貼り付けるようユーザーに求めることはありません。

これらのスコープが要求される理由

• user:read：アカウントの API ステータス、ドメイン、タグ、短縮リンク一覧、分析情報を読み取ります。
• user:write：アカウントのプランで許可されている場合に、短縮リンクの作成、編集、削除、復元を行います。

ツールの利用可否

アクセスレベル	利用可能なツール
匿名	create_short_link
サインイン済み	create_short_link、get_api_status、get_api_usage_by_external_id、get_my_domains、get_my_tags、get_my_tracking_tools、list_short_links、delete_short_link、get_link_overview、get_link_daily_clicks、get_link_platforms、get_link_referrers、get_link_regions
Advanced プラン	サインイン済みツールに加えて、edit_short_link と get_link_audience_labels。Advanced フィールドと検索フィルターも有効になります

ツールの利用可否は接続時に決まります。現在のアカウントで利用できる正確なツールを確認するには、MCP クライアントのツールインスペクターまたは tools/list を使用してください。

プライバシーとセキュリティ

• PicSee のアクセストークンをプロンプト、課題、スクリーンショット、ログで共有しないでください。
• 短縮リンクを作成または編集する前に、リンク先 URL を確認してください。
• 分析情報には非公開のキャンペーン情報やオーディエンス情報が含まれる場合があります。共有する相手は必要な人に限定してください。
• PicSee アカウントから OAuth の権限を取り消すことができます。

PicSee Privacy Notice と Terms of Use をご覧ください。

ドキュメントとサポート

• MCP とエージェントスキルのガイド
• PicSee API ドキュメント
• PicSee ヘルプセンター
• 技術的な問題を報告

問題を報告する際は、MCP クライアント名、実行した操作、タイムスタンプ、個人情報を除いたエラーメッセージを記載してください。アクセストークンや非公開の分析データは含めないでください。

開発

前提条件：

• Node.js 22 以降
• pnpm

pnpm install
pnpm check
pnpm dev

リリース前に、package.json、server.json、MCP の initialize レスポンスに記載されたバージョンがすべて同一であることを確認してください。

ライセンス

MIT © PicSee Inc.