AIアシスタントとつながるMCP連携

AIから、実績・案件を管理。

実績の下書きづくりから、案件の検索・応募、メッセージのやり取りまで。いつものAIとの会話で、剣を操作できます。

接続手順を見る

AIアプリのMCP設定に登録してください。接続先は、いま開いているサイトと同じ環境です。

3ステップで、AIと剣をつなぐ。

剣のアカウントと、MCP・OAuth認証に対応したAIアプリが必要です。

  1. ログインして名義を選ぶ

    認証に使うブラウザーで先に剣を開き、ヘッダーで操作する個人・企業を選びます。

  2. URLを登録

    上のURLを、使うAIアプリのMCP設定に貼り付けます。

  3. 権限を確認して同意

    AIアプリで接続を進め、連携先と許可する操作を確認して同意します。

アプリ別の設定

使うアプリを選ぶと、詳しい手順が開きます。

アカウントをお持ちでない方は 剣にログイン・新規登録

ChatGPT(Web版)

カスタムMCPサーバーを追加できるアカウントが必要です。

  1. ChatGPTの「Plugins」を開き、追加ボタンから「Add custom MCP server」を選びます。
  2. 名前に「剣」、Server URLに上のURLを入力し、認証はOAuthを選びます。登録方式を指定する場合は自動登録(DCR)を選びます。
  3. プラグインを作成し、手順1と同じブラウザーで剣にログインします。許可する操作を確認して連携に同意します。
  4. 作成したプラグインをインストールし、会話で剣を選びます。未認証の場合は接続操作からログインしてください。
OpenAI公式:ChatGPTへの追加手順
Claude

個人プランと組織プランで、追加する画面が異なります。

個人プランの場合

  1. 「Customize」→「Connectors」を開き、「+ Add」→「Add custom connector」を選びます。
  2. 接続名に「剣」、リモートMCPサーバーURLに上のURLを入力します。
  3. 「Sign in now」に進み、OAuthクライアントは「Register automatically」を選びます。手順1と同じブラウザーで剣にログインして連携に同意します。
  4. 追加を完了し、会話入力欄の追加メニューから剣のコネクターを有効にします。

Team・Enterpriseの場合

  1. 管理者が「Organization settings」→「Connectors」→「Add」→「Custom」→「Web」を開き、名前に「剣」、URLに上の接続先を入力します。
  2. OAuth認証と「Register automatically」を選んで、コネクターを追加します。
  3. メンバーは「Customize」→「Connectors」で剣の「Connect」を選びます。手順1と同じブラウザーでログイン・同意を完了し、会話で剣を有効にします。
Anthropic公式:カスタムコネクターの追加手順
Codex CLI

Codex CLIを導入済みのPCで設定します。以下のコマンドはmacOS・Linux、WindowsのPowerShell・コマンドプロンプトで使えます。

  1. まず codex mcp list で「tsurugi」の有無と接続先を確認します。同じURLで登録済みなら追加は飛ばします。別のURLなら既存設定は変更せず、以下の tsurugi を未使用の名前に置き換えてください。
  2. 「tsurugi」が未登録の場合だけ、次のコマンドを実行します。登録済みの名前で再実行すると、ツールや権限の設定を上書きします。
    codex mcp add tsurugi --url https://tsurugi.marketing/mcp
  3. 追加すると通常は自動で認証が始まります。手順1と同じブラウザーでログインし、権限に同意します。認証が始まらず未認証の場合だけ codex mcp login tsurugi を実行してください(別名で追加した場合は名前を読み替えます)。
  4. Codexの会話を開き直し、/mcp で接続状態を確認してください。接続済みなら再認証は不要です。
OpenAI公式:CodexのMCP設定

公式資料を基にした設定例です。剣とのアプリ別の実接続は未検証です。

接続できたら、ひと言試す

「剣に登録している自分の実績を一覧で見せて」

剣のツールが実行され、一覧が返れば接続完了です。実績が未登録の「0件」も正常です。

知っておきたいこと

公開・応募・メッセージ送信は実際の操作として反映されます。操作名義と対象を確認してAIへ依頼してください。

どのアカウントで操作されますか?

案件・応募・会話は、連携に使ったブラウザーで選択中の個人・企業名義です。同意画面では名義を選べないため、事前に剣のヘッダーで切り替えてください。公開・応募・送信前には、AIに「剣の get_order_account で現在の名義と書き込み権限を確認して」と依頼します。実績と受注者プロフィールは本人の個人名義です。

公開前に確認することは?

まず下書きで作成するようAIに依頼し、タイトル・本文・公開範囲を確認してから公開してください。

画像もアップロードできますか?

画像は剣のWeb画面からアップロードしてください。MCPでのアップロードには対応していません。

接続・操作がうまくいかないときは?

会話で剣が有効か確認し、認証エラーの場合は接続し直してください。一部の操作だけできない場合は、許可した操作と企業の権限を確認してください。設定メニューがない場合は、アプリの公式手順や組織の利用制限をご確認ください。