使用する tool
候補 ID で登録する
検索結果の id を masterCompanyId に指定します。
{
"masterCompanyId": "00000000-0000-0000-0000-000000000000"
}MCP クライアントへの依頼例です。
さきほどの検索結果の1件目を AISFA の Companies に登録してください。法人番号で登録する
法人番号が確定している場合は、検索候補の ID を使わずに登録できます。
{
"corporateNumber": "1234567890123"
}結果の見方
| 項目 | 意味 |
|---|---|
created |
true なら新規 Companies record を作成、false なら既存 record を返しています。 |
matchedBy |
corporate_number、name_address、created のいずれかです。 |
record.id |
AISFA の Companies record ID です。登録後の確認や追記に使います。 |
master.corporateNumber |
登録元の法人番号です。 |
登録される主な項目
企業マスターから Companies record へ、名称、法人番号、住所が入ります。
{
"name": "サンプル株式会社",
"corporateNumber": "1234567890123",
"address": {
"postCode": "1000000",
"prefecture": "東京都",
"city": "千代田区",
"street": "1-1-1",
"outside": null
}
}
workspace の Companies に
corporateNumber field が無い場合、登録処理が system field として追加します。
よくあるエラー
| エラー | 確認すること |
|---|---|
FORBIDDEN |
MCP 接続に使ったユーザーまたは API キーに Companies の update 権限があるか確認します。 |
COMPANY_MASTER_NOT_FOUND |
masterCompanyId または corporateNumber が検索結果と一致しているか確認します。 |
OBJECT_NOT_FOUND |
対象 workspace で標準オブジェクト companies が利用可能か確認します。 |
VALIDATION_FAILED |
Companies の必須 field や field 設定と、企業マスターから作られる data が矛盾していないか確認します。 |
監査ログ
新規作成時は record.created と company_master.registered が記録されます。既存 record に一致した場合も company_master.registered が記録され、created: false と一致理由が metadata に残ります。