AIアシスタント（MCP）を接続する

MCP（Model Context Protocol）は、AIアシスタントとKanorioの間の翻訳者の役割を果たします。接続が完了すれば、ダッシュボードを手動で操作する必要はありません。ChatGPT、Claude、またはCursorに対して、「手作りパン屋のサイトを作成して。ヒーローセクション、パンの紹介3つ、FAQセクションをホームページに追加し、確認用に下書きとして保存して」と自然な言葉で伝えるだけで、AIがKanorio上で作業を代行します。

• MCPサーバーURL: https://app.kanorio.com/api/mcp

ステップ1：接続方法を確認する

ツールに応じて、以下の2つの接続方法があります。

使用するツールがどちらの方法に対応しているか不明な場合は、"アカウント設定 › APIアクセス"に移動し、「キーを作成」をクリックしてください。最初のステップでツールを選択します。OAuthリンクに対応したツールを選択した場合、新しいキーを作成することなく、画面上に直接サーバーURLが表示されます。

どちらの方法でもセキュリティルールは共通です。AIは、あなたが許可した権限を超えた操作を行うことはできず、また、そのサイトにおけるあなたのメンバー権限を超えることもできません。

方法1：OAuthリンク経由で接続する（ChatGPT、Claudeなど）

ChatGPT、Claude、Gemini、Zapier、Makeなど、組み込みの「コネクタ」を持つツールに適しています。ChatGPTとClaudeの例を挙げます。

1. ツールにKanorioコネクタを追加する

• ChatGPT: 「設定」→「コネクタ」を開き（カスタムコネクタを使用する場合は開発者モードを有効にしてください）、「作成」を選択します。名前をKanorioとし、MCPサーバーURL https://app.kanorio.com/api/mcp を入力し、認証方法としてOAuthを選択します。
• Claude: 「設定」→「統合」または「コネクタ」を開き、「リモートMCPサーバーを追加」を選択します。名前をKanorio、URLを https://app.kanorio.com/api/mcp と入力します。

2. サイトを選択し、Kanorio認証ページで「許可」をクリックする

保存後、ブラウザでKanorioの認証ページが開きます。

1. 画面に表示されているKanorioアカウントが正しいことを確認します。
2. 「このアプリケーションは以下の操作が可能です」の下にある権限リストを確認します。権限はアプリによって要求されます（指定がない場合、システムはデフォルトで「コンテンツ編集」プランを適用します。これにより、ページやブログの下書きの閲覧・編集が可能になりますが、サイトの公開や非公開化はできません）。
3. 「アクセス可能なサイト」の下で、AIに管理させたいサイトのみを選択します。AIにゼロから新しいサイトを作成させたい場合は、「すべてのサイト（将来の追加分を含む）」を選択してください。
4. 「許可」をクリックしてツールに戻り、チャットボックスでKanorioツールを有効にして開始します。

再度認証を求められましたか？ 最初はデフォルトの「コンテンツ編集」権限で接続し、後からAIに「サイトを公開」や「カスタムドメインをバインド」するように依頼した場合、AIアシスタントが自動的に認証ページへ案内し、不足している権限を付与するよう求めます（新しい項目には「新規」とマークされます）。確認して「許可」をクリックし、続行してください。認証画面の詳細やアクセス権の取り消し方法については、を参照してください。

Gemini利用時の注意: Googleは現在、Geminiウェブの「カスタムアプリ」の利用を、英語インターフェースを使用する18歳以上の米国個人アカウントに限定しています。Gemini Enterpriseは、固定クライアントシークレットの要件により、現在サポートされていません。

方法2：APIキー経由で接続する（Cursor、Claude Codeなど）

Cursor、Claude Code、GitHub Copilot (VS Code)、Windsurf、Perplexity、n8n、およびカスタムプログラムに適しています。

1. キーを作成し、設定をコピーする

1. "アカウント設定 › APIアクセス"に移動し、「キーを作成」をクリックします。
2. ツールを選択: 接続したいツールのアイコンをクリックします（例：CursorやClaude Code）。
3. アクセス可能なサイトを選択: 既存のサイトの場合は、その特定のサイトのみを選択することを推奨します。AIにゼロから新しいサイトを作成させるには、「すべてのサイト（将来の追加分を含む）」を選択してください。
4. 権限プランを選択:
   • デフォルトの「コンテンツ編集」プランでは、AIがページモジュールの変更、画像のアップロード、ブログの下書き作成を行えます（公開前に確認できるため最も安全です）。
   • AIに公開作業、ドメインバインド、商品管理まで任せたい場合は、「フル管理」を選択してください。
5. 有効期限を選択し、本人確認を行ってから作成をクリックします。キーのローテーションについては、を参照してください。

2. ツールに設定を貼り付ける

キーが作成されると、キーとサーバーURLが入力済みの設定が生成されます。「設定をコピー」をクリックし、適切な場所に貼り付けてください。

Cursor設定 (.cursor/mcp.json) の例:

{
  "mcpServers": {
    "kanorio": {
      "url": "https://app.kanorio.com/api/mcp",
      "headers": {
        "Authorization": "Bearer knr_pat_your_key"
      }
    }
  }
}

Claude Code ターミナルコマンドの例:

claude mcp add --transport http kanorio https://app.kanorio.com/api/mcp \
  --header "Authorization: Bearer knr_pat_your_key"

ローカルの設定ファイルにキーを保存したくない場合 CursorやClaude CodeもOAuthリンクをサポートしています。Cursor設定の headers フィールド、またはClaude Codeの --header パラメータを省略してください。初回使用時にツールが自動的にブラウザを開き、Kanorioの認証ページへ誘導します。これらのツールはローカルで実行されるため、黄色い「ID未確認」という警告が表示される場合がありますが、これは「このデバイスのプログラムに戻ります」という内容です。自身で接続を開始したものであれば、安全に「許可」をクリックできます（を参照）。

AIアシスタントにできること（安全性の境界線）

下書きと即時反映の違い

AIにサイトを管理させる前に、どの操作に「下書きバッファ」があるかを理解しておきましょう。

• 下書きとして保存（公開するには「公開」が必要）:
  • ページ上のすべてのモジュールコンテンツとレイアウトの変更。
  • ヘッダーナビゲーション、フッター、サイト全体のボタン、ソーシャルリンクの変更。
  • サイトの外観設定（ブランドカラー、フォント、角のスタイル、密度、ダーク/ライトモード、コンテンツ言語）の変更。
  • ブログ記事の追加または変更（新規記事は常に下書きとなり、別途公開する必要があります）。
• 公開サイトに即時反映:
  • ページのURLスラッグ、表示状態、ページごとのSEOフィールドの変更。
  • ストア商品の追加、変更、アーカイブ（商品に下書き状態はなく、変更は即座に公開されます）。
  • サイトの公開、サイトの非公開化、カスタムドメインのバインドの実行。

AIができないこと

アカウントのセキュリティ、財務、顧客のプライバシーを保護するため、以下の操作はシステムレベルでAIやAPI経由での実行が厳格に禁止されています。「フル管理」権限があっても、これらはKanorioダッシュボード上であなた自身が行う必要があります。

• データのエクスポートとプライベートファイル: サイトバックアップのエクスポート、注文/顧客/マーケティング/分析用のCSVエクスポート、フォーム添付ファイルのダウンロード。
• 支払い、注文、請求: 返金処理、注文ステータス/メモの変更、サイト通貨の変更、商品価格プランの変更、サブスクリプション請求や支払い方法の管理。
• 不可逆的な顧客・マーケティング操作: 連絡先の削除、連絡先の一括インポート、ニュースレターの直接送信/予約（AIは下書き作成のみ可能で、ダッシュボードでの確認が必要です）。
• 権限と所有権: チームメンバーの招待/削除、サイト所有権の譲渡、サイトやブログ記事の完全削除。

機能とMCPツールリファレンス

接続後、AIは以下の17の機能を呼び出すことができます（右側のツール名はエンジニアリング用リファレンス、またはCursor/Claudeでの呼び出しログ確認用です）。

推奨されるワークフローと実践的なプロンプト

AIサイト構築のベストプラクティス

AIアシスタントは、以下の7つのステップに従うと最も効果的に機能します（この順序は sections_describe ガイドに組み込まれており、AIは自動的にこれに従います）。

1. モジュール仕様を確認: AIに利用可能なモジュールとフィールドの制限を理解させます。
2. サイトを作成または選択: 新しいサイトを構築するか、既存のサイトをリストアップしてターゲットを確認します。
3. ブランド外観とグローバルボタンを設定: ブランドカラー、フォント、グローバルボタン（例：「今すぐ予約」）を最初に設定し、新しいページに一貫して適用されるようにします。
4. 画像を準備: 写真をAIに送信するか、無料のストックライブラリから選ぶよう依頼します（次セクションを参照）。
5. ページを書き換え、ナビゲーションを更新: AIに現在のページを読み込ませてから書き換えを行います。新しいページを追加した後は、必ずヘッダーナビゲーションを更新するようAIに依頼してください。
6. 下書きを確認して公開: エディタで下書きをプレビューし、AIに公開を依頼します（初回公開には .kanorio.com サブドメインが必要です）。
7. ドメインをバインドしてDNSを確認: カスタムドメインがある場合は、AIにバインドとDNSステータスの確認を依頼します。

コピー＆ペースト用プロンプトテンプレート

例1: ブランドサイトをゼロから構築する（下書きモード）

Kanorioで新しいブランドサイトを作成してください：
- ブランド名: [ブランド名]
- 業界と紹介: [ビジネスとサービスの説明]
- スタイルと色: [例：温かみのあるアースカラー、柔らかい角丸、明るい背景]
- プライマリボタン: [例：今すぐ予約（https://instagram.com/example へのリンク）]
「ホームページ」と「会社概要」ページを計画して作成してください。パン屋のテーマに合うストックフォトを選んでください。作成後、ヘッダーナビゲーションを更新し、公開前に確認できるよう下書きとして保存してください。

例2: 既存ページの書き換えとSEO最適化

Kanorioにある私の [ブランド名] サイトを読み込んでください：
1. 現在のホームページのモジュールを確認し、文章をより魅力的に書き換え、下部に「FAQ」モジュールを追加してください（保管方法、予約時間、アレルギーに関するQ&Aを4つ含めてください）。
2. サイト内の全ページのSEOタイトルと説明を確認し、更新してください。
下書きとして保存し、まだ公開はしないでください。また、何を変更したか教えてください。

例3: 写真のアップロードとブログ記事の下書き

私の [ブランド名] サイトに「秋の栗サワードウ発売」に関するブログ記事を追加し、ホームページのヒーロー画像を新しく撮った写真に更新したいです。写真をアップロードするためのリンクを提供してください。アップロード後、画像を更新してブログの下書きを作成してください。

AIはどうやって画像を取得するのか？

なぜチャットに貼り付けた写真をAIは使えないのか？

セキュリティ上の制限により、ChatGPT/ClaudeはAIがチャット内の画像を「見る」ことは許可していますが、生の画像ファイルをKanorioに転送することはできません。サイトに画像が必要な場合、AIは以下の4つの経路のいずれかをたどります。AIの指示に従ってください。

メディアライブラリとゴミ箱のルール

• 24時間クリーンアップ: AI経由でアップロードされ、24時間使用されなかった画像は、スペースを節約するために自動的に回収されます。
• ゴミ箱と30日間の復元: AIにメディアライブラリを整理させ、未使用のファイルをゴミ箱 (media_trash) に移動させることができます。ゴミ箱内のファイルはサイト上での表示は停止しますが、ストレージ容量にはカウントされます。AIまたはを通じて 30日以内 であれば復元 (media_restore) 可能です。完全に削除するには、AIに依頼してください (media_purge。画像がまだ使用中かどうかを確認します)。デジタル商品のダウンロードファイルは保護されており、ゴミ箱に移動することはできません。
• 画像の上書き: ダッシュボードで古い画像を新しい画像に置き換え、AIがゴミ箱から古いバージョンを復元した場合、システムはそれを新しい独立したファイルとして復元します。新しいバージョンを使用しているページには影響しません。

利用制限と注意点

• レート制限: 各APIキー（または認証済みアプリ接続）は、一般的な操作に対して 1分間に最大120回 の呼び出しが可能です。公開/非公開化（サイト/ブログ記事）は 1時間に30回 に制限されています。これを超えた場合、AIが数秒待つよう通知します。
• AIクレジットとプラン: 「AIサイト構築」機能（brief モードでの sites_create）を使用すると、アカウントのAIクレジットと1日のサイト構築制限が消費されます。無料プランの制限（ページ数、表示モジュール）が適用されます（を参照）。
• マルチユーザー/ツール保護: AIがページを編集している最中にダッシュボードで同じページを編集すると、上書きを防ぐためにシステムが2回目の書き込みをブロックし、更新を要求します。人間とAIでタスクを分担することを推奨します。
• 訪問者データの取り扱い: フォームの回答、連絡先情報、注文メモは、ツール説明において「信頼できない訪問者データ」としてマークされます。AIはこれらを指示ではなくデータとして扱う必要があります。AIに外部からの訪問者メッセージを読み込ませる際は、キーを「コンテンツ編集」または「閲覧のみ」に設定してください。
• ベータ版ステータス: MCPツールとREST APIはベータ版です。ツールが非推奨となった場合、ツール説明に代替案が提示されます（AIは自動的に切り替わります）。お知らせは API変更履歴 に掲載されます。ポリシーについては を参照してください。

関連ドキュメント