TOKIUM契約管理 API・MCP連携の概要

TOKIUM契約管理の公開API（/api/v1）とMCP連携の全体像、利用開始までの流れを紹介します。

Reading time: ~5 min Last modified: 2026-06-25

TOKIUM契約管理 API・MCP連携の概要

概要

TOKIUM契約管理の公開API（/api/v1）を使うと、契約書の検索・参照・編集や、フォルダ情報の取得を外部のプログラムや AI アシスタントから行えます。あわせて提供している MCP サーバを使うと、Claude や GitHub Copilot などの AI クライアントから、自然言語でそのまま契約書を扱えます。

権限制御・ビジネスロジックはすべて API 側（契約管理本体）が担うため、API キーを発行したユーザー自身の権限（閲覧・編集できるフォルダ）の範囲内でのみ動作します。権限のないフォルダの契約書が外部に漏れることはありません。

全体像

AI クライアント (Claude / Copilot など)
   │  MCP プロトコル
   ▼
tokium-contract-mcp (MCPサーバ / 薄い変換レイヤー)
   │  HTTP (Authorization: Bearer ktk_...)
   ▼
TOKIUM契約管理 公開API  /api/v1/*
  • API を直接呼ぶこともできますし（curl や任意のプログラムから）、
  • MCP 経由で AI クライアントから呼ぶこともできます。

どちらの場合も認証は同じ API キー（ktk_ で始まるトークン）を使います。

利用開始までの流れ

  1. API キーを発行する 「ユーザー設定 > API キー」画面で API キーを発行します。平文のキー（ktk_...）は発行時に一度だけ表示されるので、安全な場所に控えてください。
  2. 使い方を選ぶ
    • プログラムから直接 API を呼ぶ → API仕様 を参照
    • AI クライアント（Claude / Copilot）から使う → MCP連携 を参照
  3. 動作を確認する 契約書の一覧取得や検索を実行し、自分の権限範囲の契約書が返ることを確認します。

提供している機能

機能 説明
契約書の検索・一覧 文書名・取引先名・ステータス・フォルダ・締結日などで絞り込み
契約書の取得 UUID 指定で1件取得
契約書の編集 指定したフィールドのみ部分更新（編集権限が必要）
フォルダ一覧 アクセス可能なフォルダの一覧（権限種別付き）
フォルダ検索 フォルダ名の完全一致検索（folder_uuid の特定用）

このヘルプの構成

  • API仕様 … 認証方法・各エンドポイント・絞り込みパラメータの詳細
  • MCP連携 … Claude Code / VS Code Copilot との接続方法
  • よくある質問 … 権限・キー・トラブルシューティング
← Back to List

Related Documents

API仕様 → MCP連携（Claude / Copilot） →