【MCP Server】freee Project Management × Claude Code 連携ガイド:CData MCP Server で AI 駆動のアプリ開発

Anusha M B
Anusha M B
Technical Marketing Engineer
CData CData API Driver for MCP Server を使って、Claude Code からリアルタイムの freee Project Management のデータを探索し、freee Project Management のデータを活用したアプリケーション開発を支援する方法を解説します。



Claude Code は、ターミナル上で動作する AI 搭載のコマンドラインツールで、エージェント型のコーディングワークフローを実現します。MCP に対応しているため、Claude Code はローカルツールやエンタープライズデータソースにターミナルから直接接続でき、コンテキストを切り替えることなくライブシステムと自然言語でやり取りできます。

Model Context Protocol(MCP)は、構造化されたツールインターフェースを通じて LLM クライアントを外部サービスに接続するためのオープンスタンダードです。MCP Server はスキーマの検出やリアルタイムクエリなどの機能を公開し、AI エージェントがリアルタイムデータを安全かつ一貫して取得・分析できるようにします。

この記事では、CData API Driver for MCP Server のインストール、freee Project Management への接続設定、Claude Code への MCP Server アドオンの接続、そしてターミナル内からリアルタイムの freee Project Management のデータをクエリする方法までをステップバイステップで解説します。

ステップ 1:CData API Driver for MCP Server のダウンロードとインストール

  1. まずは CData API Driver for MCP Server をダウンロードします。
  2. ダウンロードしたインストーラーをダブルクリックして実行します。
  3. 画面の指示に従ってインストールを完了させます。

インストールが完了したら、freee Project Management に接続して MCP Server アドオンの設定を行います。

ステップ 2:freee Project Management への接続を設定

  1. インストール後、CData API Driver for MCP Server の設定ウィザードを開きます。

    注意:ウィザードが自動的に開かない場合は、Windows の検索バーで「CData API Driver for MCP Server」と検索し、アプリケーションを起動してください。

  2. MCP Configuration > Configuration Name で、既存の構成を選択するか、 を選択して新しい構成を作成します。
  3. 構成名を入力(例:「cdata_api」)し、OK をクリックします。
  4. 設定ウィザードに適切な接続プロパティを入力します。

    まずはOAuth アプリを作成します。https://app.secure.freee.co.jp/developers/applications にアクセスして、「新しいアプリケーションの作成」ボタンをクリックします。アプリケーション名を指定し、リダイレクトURL を設定して登録をクリックします。そうすると、クライアントシークレットとクライアントID が発行されます。

    次に、プロファイルをダウンロードしてドライバーがアクセス可能な場所に配置します。こちらからプロファイルをダウンロードして、「C:/profiles/」 などに設置してください。

    その後、Companies ビューからCompanyId を取得します。以下の接続プロパティを設定したら、接続する準備ができます。

    • AuthScheme:OAuth に設定します。
    • OAuthClientID:アプリ設定で指定されたOAuth クライアントID に設定します。
    • OAuthClientSecret:アプリ設定で指定されたOAuth クライアントシークレットに設定します。
    • CallbackURL:アプリ設定で指定したリダイレクトURI に設定します。
    • InitiateOAuth:GETANDREFRESH に設定します。InitiateOAuth を使用してOAuthAccessToken を取得するプロセスを管理できます。
  5. 接続 をクリックして、OAuth 経由で freee Project Management と認証します。
  6. 次に、Save Configuration をクリックして MCP Server アドオンの構成を保存します。

この操作により、Claude Code が MCP Server アドオンを起動する際に参照する .mcp 構成ファイルが作成されます。MCP Server アドオンの設定が完了したら、続いて Claude Code に接続していきましょう。

ステップ 3:MCP Server アドオンを Claude Code に接続

  1. ターミナルから Claude Code CLI をインストールします。
  2. Claude Code の構成ファイル ~/.config/claude-code/config.json(または初期化後に表示されるパス)を開きます。

方法 1:MCP 構成を手動で追加

  1. mcp.json ファイルをお好みのエディタで開きます。
  2. 以下のコードを追加します。
  3. {
    "mcpServers" : {
      "cdata_api" : {
        "type" : "stdio",
        "command" : "C:\Program Files\CData\CData API Driver for MCP Server\jre\bin\java.exe",
        "args" : [ "-Dfile.encoding=UTF-8", "-jar", "C:\Program Files\CData\CData API Driver for MCP Server/lib/cdata.mcp.api.jar", "cdata_api" ],  
        "env" : {}
      }
    }
    }
    

    注意:command の値は Java 17 以上の java.exe 実行ファイルのパスを、JAR パスにはインストール済みの CData MCP Server アドオンの .jar ファイルのパスを指定してください。最後の引数は、CData 設定ウィザードで保存した MCP 構成名と一致させる必要があります(例:「cdata_api」)。

方法 2:CData API Driver for MCP Server の UI から MCP 構成をコピー

  1. 設定ウィザードで接続の保存とテストが完了したら、Next をクリックします。
  2. AI MCP Tool ドロップダウンから Claude Code を選択します。
  3. Copy JSON をクリックして、生成された MCP 構成をクリップボードにコピーします。
  4. コピーした JSON を mcp.json ファイルに貼り付けます。

ステップ 4:Claude Code で接続を確認

Claude Code には、ビルド開始前に接続がアクティブであることを確認するためのツールが用意されています。

  1. ターミナルを開き、プロジェクトディレクトリに移動して claude mcp list コマンドを実行します。
  2. 構成名が Connected ステータスで表示されることを確認します。
  3. claude コマンドを実行して Claude Code を起動します。
  4. Claude Code セッション内で /mcp と入力し、アクティブなサーバーを確認します。

ステップ 5:Claude Code でリアルタイムの freee Project Management のデータをクエリ

接続が確認できたら、自然言語のプロンプトを使ってリアルタイムの freee Project Management のデータをクエリ・操作できます。

  1. Claude Code に MCP 接続の手順を確認するようプロンプトを入力し、コード記述時に適切なコンテキストが揃っていることを確認します。
  2. 自然言語のプロンプトでビルドを開始しましょう!例えば:
    プロジェクトでは Projects のデータが非常に重要です。Id や ProjectName などの主要なカラムからデータを取得してください。

Claude Code は MCP アドオンを使用して freee Project Management に接続し、リクエストされたデータを取得して、ターミナル上に直接結果を表示します。

AI を業務データにつなげて、業務を圧倒的に効率化!

MCP Server を無料でダウンロードして、AI ツールに開発中のリアルタイム freee Project Management のデータへのスキーマ対応アクセスを提供しましょう。本番環境への移行準備が整ったら、CData freee Project Management Drivers がエンタープライズグレードのパフォーマンス、セキュリティ、信頼性を備えた同等の SQL ベースアクセスを提供します。

CData コミュニティにアクセスして、洞察を共有したり、質問したり、MCP を活用した AI ワークフローの可能性を一緒に探っていきましょう。

はじめる準備はできましたか?

API Driver で freee Project Management のライブデータに接続

freee Project Management に接続