Field Control MCP Server

Claude を Field Control の統合 API (https://developers.fieldcontrol.com.br/) に接続するリモート MCP (Model Context Protocol) サーバーです。Claude との会話で直接、顧客、サービスオーダー、作業員、サービスリクエスト、機器などを照会・作成できます。

公開するもの

Claude が利用できるツール:

Related MCP server: Jobber MCP Connector

1. Field Control の API キーを取得する

1. 管理者として Field Control のパネルにアクセスします。

2. 設定 > 開発者向け設定 に移動します (または直接: https://app.fieldcontrol.com.br/#/configuracoes/configuracao-para-desenvolvedores)。

3. 「統合キー」で、新しいキーを作成するためにクリックし、名前を付けて 作成 をクリックします。

4. このキーを保管してください。環境変数 FIELD_CONTROL_API_KEY として使用します。

2. ローカルで実行する (任意、テスト用)

npm install
FIELD_CONTROL_API_KEY="sua-chave-aqui" npm start

サーバーは http://localhost:3000 で起動し、MCP エンドポイントは POST /mcp です。

3. サーバーをインターネットに公開する (Claude がアクセスするために必要)

Claude は Anthropic のクラウドから接続するため、サーバーは HTTPS で公開アクセス可能である必要があります。Node.js を実行できるプロバイダーならどれでも動作します。無料枠がある簡単な2つのオプション:

オプション A: Render.com

1. このプロジェクトを GitHub リポジトリにプッシュします。

2. Render で、リポジトリを指す Web Service を作成します。

3. ビルドコマンド: npm install — スタートコマンド: npm start。

4. 「Environment」で、変数 FIELD_CONTROL_API_KEY にキーを追加します。

5. デプロイ後、https://seu-app.onrender.com のような URL が得られます。MCP エンドポイントは https://seu-app.onrender.com/mcp になります。

オプション B: Railway.app

1. プロジェクトを GitHub にプッシュします。

2. Railway で、「New Project」>「Deploy from GitHub repo」を選択します。

3. 環境変数 FIELD_CONTROL_API_KEY を追加します。

4. Railway は npm start を自動的に検出し、公開 URL を公開します。

(他の Node.js ホスト — Fly.io、Vercel functions、Nginx を使った自前の VPS など — も、/mcp を HTTPS で公開すれば同様に動作します。)

4. カスタムコネクタとして Claude に接続する

1. Claude で、設定 > コネクタ に移動します。

2. + をクリックし、次に カスタムコネクタを追加 をクリックします。

3. サーバーの URL を /mcp で終わる形で貼り付けます (例: https://seu-app.onrender.com/mcp)。

4. 名前を付け (例: "Field Control")、追加 をクリックします。

これで完了です。今後の会話で、Claude はあなたのサービスオーダー、顧客、作業員などを、リクエストに応えるのに役立つ場合にいつでも一覧表示できます。

Team/Enterprise プランでは、所有者が最初に組織設定 > コネクタ > 追加 > カスタム > Web でコネクタを有効にする必要があります。その後、各メンバーが自分のアカウントを接続します。

セキュリティ

• API キーはサーバー上のみ (環境変数) に保存され、Claude やブラウザに公開されることはありません。

• デフォルトでは、このサーバーを使用する全員が同じ API キー (環境のもの) を共有します。異なるキーを持つ複数の人にこのコネクタを提供したい場合は、src/server.js の getApiKeyFromRequest() を、リクエストごとにヘッダーからキーを読み取るように変更し、各人がコネクタの「詳細設定」でこれを設定するようにしてください。

• API キーをリポジトリにコミットしないでください。常にホスティングプロバイダーの環境変数を使用してください。