FlipLink MCP サーバー
AIアシスタントからFlipLinkを操作できます。Claude、Cursor、その他のMCP対応クライアントが、フリップブックの作成・設定・公開・管理を自然言語で実行。破壊的な操作にはガードレールを標準搭載しています。
コピー&ペーストひとつで接続
スタータープロンプトを Claude Code に貼り付けるだけで、FlipLink MCP サーバーが追加され、動作確認まで自動で行われます。
YOUR_API_KEY を、ご自身の FlipLink API キーに置き換えてください。
Set up and verify the FlipLink MCP server for me.
1. Add the server to this Claude Code session by running this in the terminal:
claude mcp add fliplink -e FLIPLINK_API_KEY=YOUR_API_KEY -e FLIPLINK_MCP_MODE=safe -- npx -y fliplink-mcp
2. Confirm it was added: run `claude mcp list` and check that "fliplink" appears and shows as connected.
3. Verify the config: confirm the "fliplink" server has FLIPLINK_API_KEY set in its env (it must be my real
key, not the YOUR_API_KEY placeholder, and must not be empty). Reading config: `claude mcp get fliplink`.
4. Test the connection: call the FlipLink "whoami" tool. If it returns my account, the MCP is live.
5. If "fliplink" is missing or won't connect, troubleshoot:
- Ensure Node.js 18+ and npx are installed (`node -v`).
- Re-run the add command and confirm FLIPLINK_API_KEY is present and correct (not the placeholder).
- Remove and re-add: `claude mcp remove fliplink` then re-run step 1; restart the session.
- Re-run `claude mcp list` to confirm it now shows connected.
Once "whoami" succeeds, list the FlipLink tools now available to you.お使いの AI ツールと連携
Claude
Cursor
ChatGPT
Codex
VS Code
Windsurf
npx fliplink-mcp でインストール · 自分のAPIキーを使用 · 87 個のツール
仕組み
FlipLink MCP サーバーは、AIクライアントがあなたのマシン上で実行する小さなプログラムです。同じ FlipLink REST API をMCPツールとして公開するため、アシスタントが自然言語で呼び出せます。同じAPIへの3つ目の入り口であり、CLI の兄弟分です。APIの仕様は何も変わりません。このサーバーはもう1つのクライアントにすぎず、すべてのガードレールはリクエストがマシンを離れる前にローカルで動作します。
インストール
手動でインストールするものはありません。AIクライアントが npx でサーバーを起動します。必要なのは自分のFlipLink APIキーだけです（下記を参照）。
Claude Code
claude mcp add fliplink -e FLIPLINK_API_KEY=<YOUR_KEY> -- npx -y fliplink-mcpClaude Desktop · Cursor · Codex
クライアントのMCP設定（mcpServers ブロック）に次の内容を追加してください。
{
"mcpServers": {
"fliplink": {
"command": "npx",
"args": ["-y", "fliplink-mcp"],
"env": {
"FLIPLINK_API_KEY": "<YOUR_KEY_FROM_SUBSCRIPTION_PAGE>",
"FLIPLINK_MCP_MODE": "safe"
}
}
}
}APIキーを取得
各ユーザーは自分のキーを用意します。こちらで事前に入力することはありません。サインインしてサブスクリプションページからキーをコピーし、上記の設定の FLIPLINK_API_KEY に貼り付けてください。
キーが設定されていない場合、すべてのツールが追加方法をわかりやすく案内します。そのため、ドキュメントを読む前でも、アシスタントがセットアップをサポートしてくれます。
スタータープロンプト
新しいAIセッションに貼り付けるだけで、安全なワークフローをすぐに始められます。
You now have the FlipLink MCP server connected (tools like whoami,
flipbook_create_by_file, leads_list). First, call whoami to confirm my account is reachable.
If it returns an auth error, ask me to paste my FlipLink API key (I get it from
https://go.fliplink.me/Subscription) and remind me to put it in the MCP server config as
FLIPLINK_API_KEY, then stop until I confirm.
Once connected you can create, list, and configure my flipbooks. For any delete, sale/pricing,
or access-control change, show me a one-line preview and wait for my explicit "yes" before doing it.
Here's what I want to do: <describe your task>モード
安全設計
full モードでは、破壊的な操作（削除）や金銭にかかわる操作（販売・価格設定）のツールが、最初の呼び出しで実行されることはありません。サーバーは1行のプレビューと短時間だけ有効な confirm_token を返します。アシスタントはそのプレビューを表示し、トークンを添えて再度呼び出す必要があります。トークンは指定された引数と紐づいており、5 分で失効します。この仕組みはサーバー内で完結し、FlipLink API がこれを認識することはありません。
各ツールにはMCPアノテーション（readOnlyHint、destructiveHint、idempotentHint）も付与されているため、クライアント側で独自の承認プロンプトを表示できます。
ツール
ツールはAPI仕様から生成され、<noun>_<verb> の形式で命名されます。たとえば flipbook_publish、flipbook_set_skin、leads_list、cname_add などです。唯一のトップレベルのヘルスチェックツールは whoami です。各エンドポイントのパラメータの詳細は、REST API ドキュメント をご覧ください。
よくあるご質問
- MCPサーバーとは何ですか？
MCP（Model Context Protocol）サーバーとは、お使いのAIクライアントがローカルで実行し、アシスタントにツールを公開する小さなプログラムです。FlipLinkのサーバーはFlipLink REST APIと同じ機能をツールとして公開するため、Claude、Cursor、その他のMCPクライアントから、自然な言葉でフリップブックの作成・設定・公開ができます。
- 対応しているAIクライアントは何ですか？
Claude Code、Claude Desktop、Cursor、CodexをはじめとするMCP対応クライアントであれば利用できます。クライアントの
mcpServers設定にFlipLinkを追加すると、必要に応じてnpx fliplink-mcpでサーバーが起動します。- readonly、safe、fullの各モードとは何ですか？
モードによって公開するツールが決まります。
readonlyは読み取り専用の19個のツールを公開します。safe（デフォルト）はこれに可逆的な書き込みとアクセス制御を加えた79個のツールを公開します。fullは全87個を公開しますが、削除や課金に関するツールは確認ステップを挟んで保護されます。モードはFLIPLINK_MCP_MODEで設定します。- AIにフリップブックを管理させても安全ですか？
はい。fullモードでも、破壊的な操作（削除）や課金に関わる操作（販売・価格設定）が最初の呼び出しで実行されることはありません。サーバーは一行のプレビューと、指定した引数に紐付いた短時間有効の確認トークンを返し、アシスタントが確認するまで何も実行しません。こうしたガードレールはすべてローカルで動作し、FlipLink API自体には変更を加えません。
- 自分専用のAPIキーは必要ですか？
はい。各ユーザーがFlipLinkのサブスクリプションページで取得した自分のキーを用意し、設定で
FLIPLINK_API_KEYとして指定します。キーが未設定の場合は、すべてのツールがわかりやすいセットアップ手順を返すので、アシスタントが設定を案内できます。