ClaudeとNetSuiteを連携する方法
Anthropic公式ConnectorsディレクトリのNetSuite AI Connectorで、ClaudeにNetSuiteの売上・会計データを問い合わせる設定手順を解説します。
NetSuite AI Connectorで何ができるか
NetSuite AI ConnectorはAnthropicの公式Connectorsディレクトリに掲載されている連携先です。Claude・Claude Desktop・Claude Codeのほか、Claude APIのMCP Connector経由でも使え、接続後はNetSuiteの売上データや会計データを自然文で問い合わせられます。「8月にAmerican Meats Incがいくら購入したか」のような具体的な質問をそのまま投げられます。
提供元はOracle NetSuite自身です。カテゴリはDataとFinancial servicesの2つにまたがり、Capabilityバッジは読み取りと書き込みの両方が可能な「Read & write」と、対話的なUIをその場に描画できる「Interactive」の2つが付いています。売上分析や口座分析、条件を絞った受注検索まで、標準レポート・保存済み検索・レコード操作・SuiteQLクエリの4段階でNetSuiteのデータへ到達する設計です。
NetSuiteは専用のSkillを2つ公式に配布しています。ツールの選び方とSuiteQLの安全策を定めた「NetSuite AI Connector Instructions」と、月次決算や財務分析に特化した「NetSuite Finance Analyst」です。後者の使い方はNetSuite Finance AnalystスキルでClaudeに月次決算を任せる方法にまとめました。
NetSuite側で必要な準備
NetSuiteはModel Context Protocol(MCP)を採用しており、AIクライアントとの安全なやり取りを支える基盤として「NetSuite AI Connector Service」を提供しています。Claudeから使うには、NetSuite側で「MCP Standard Tools SuiteApp」と「NetSuite AI Connector Service Companion SuiteApp」の2つをアカウントへ導入する管理者作業が先に必要です。
この作業はNetSuiteの管理者権限を持つユーザーが行います。営業担当者やアナリストが自分のログインだけで完結させることはできません。NetSuiteの公式ヘルプは導入と並行して「関連するリスク・コントロール・軽減策」という専用トピックを用意しており、AIクライアントの接続がどの範囲のデータに触れるかを事前に確認するよう案内しています。
Claudeでコネクタを追加する手順
NetSuite側の準備が終わったら、Claude側での追加は他のディレクトリコネクタと同じ流れです。
- チャット画面左下の「+」ボタン、または「/」でメニューを開きます
- 「Connectors」にカーソルを合わせ「Manage connectors」を選びます
- Connectorsの「+」からディレクトリを開き、NetSuiteを検索してクリックします
- 説明とCapabilities(Read & write / Interactive)を確認します
- 「Connect」をクリックし、NetSuiteアカウントへの認証プロンプトに従います
- 会話ごとにConnectorsメニューでNetSuiteをトグルONにすると、その会話でClaudeが使えるようになります
接続時にClaudeへ渡る権限は、あなたがNetSuiteアカウントで持つ権限を超えません。閲覧できないレコードや実行できない操作は、Connector経由でも同じように閲覧・実行できません。
チーム・Enterpriseでの組織展開
Team・EnterpriseプランではOwnerかPrimary OwnerがNetSuiteコネクタを組織向けに有効化しない限り、メンバーは使えません。
- 「Organization settings」→「Connectors」を開きます
- ページ下部の「Browse connectors」をクリックします
- 一覧からNetSuiteを選び「Add to your team」をクリックします
組織側の有効化は利用可能にするだけで、誰かに自動でアクセス権を渡すわけではありません。メンバーは自分のNetSuiteアカウントで個別に認証して初めて使えます。Enterprise-managed auth(ベータ)を使うと、組織として一度認可すれば初回ログイン時にメンバーへ自動でアクセスが引き継がれます。
書き込みを止めて閲覧だけに絞りたい場合は、Owner側で操作範囲を制限できます。
| 制限したい操作 | 設定場所 | 効果 |
|---|---|---|
| レコードの作成・更新 | 設定場所Customize → Connectors → 対象コネクタのTool permissions | 効果読み取り系ツールのみAlways allow、書き込み系をBlocked |
| 個別ツール単位の承認 | 設定場所同上(ツールごとにAlways allow / Needs approval / Blocked) | 効果特定のツールだけ承認制にできる |
Claude側で書き込みを許可しても、NetSuite側の権限が無ければ実際の書き込みは通りません。Claudeの設定は制限を狭める方向にしか働かず、NetSuiteの権限を上書きして広げることはありません。
SuiteQLの安全策とツール選択の優先順位
NetSuite AI Connector Instructionsスキルは、Claudeがどの順番でツールを試すかを厳密に定めています。
| 優先順位 | ツール | 用途 |
|---|---|---|
| 1 | ツール標準レポート(ns_runReport) | 用途まず標準レポートで答えられないか確認する |
| 2 | ツール保存済み検索(ns_runSavedSearch) | 用途レポートに無ければ保存済み検索を探す |
| 3 | ツールレコード操作(ns_getRecord 等) | 用途個別レコードの参照・作成・更新 |
| 4 | ツールカスタムSuiteQL(ns_runCustomSuiteQL) | 用途上記で答えられないときの最終手段。実行前に必ずユーザーへ確認する |
カスタムSuiteQLは最後の手段として位置づけられています。Claudeは実行前に「標準レポートや保存済み検索では見つかりませんでした。カスタムSuiteQLクエリを試してよいですか」と確認を挟む決まりです。安全チェックリストには、行数上限(ROWNUM <= 1000)の必須指定、NVL()によるNULL処理、承認済み取引だけに絞るapprovalstatus = 2条件などが並びます。
SELECT
t.id, t.tranid, t.trandate,
NVL(t.amount, 0) AS amount
FROM transaction t
WHERE t.recordtype = 'salesord'
AND t.posting = 'T'
AND t.approvalstatus = 2
AND ROWNUM <= 1000
ORDER BY t.trandate DESCこのテンプレートに沿ったクエリなら、承認済みの取引だけを1,000行の上限内で安全に取得できます。金額は$2.1Mのように単位を丸めて表示し、内部の数値IDはユーザーに見せない、という出力フォーマットのルールも同じスキルに含まれています。3つ以上の指標を比較する質問や10行を超えるデータには、その場でReactアーティファクトを自動生成する仕組みです。
つまずきやすい点
- 権限不足のエラーで止まる: NetSuite側にその操作の権限が無いと、Claudeは生のエラーをそのまま出さず、どの役割・権限が必要かを案内する設計です。エラー文面より先に、NetSuiteの役割設定を確認します
- 子会社や通貨の指定を聞かれる: 複数子会社の環境で範囲を指定しないと、Claudeは「特定の子会社ですか、連結ですか」と先に確認します。聞かれたら即答できるよう、対象の子会社名を用意しておくとやり取りが1往復減ります
- 金額が想定と違って見える: SuiteQLの
amountは基準通貨換算後の値、foreignamountは現地通貨のままの値です。海外子会社のデータを見るときはどちらの列かを意識します - 会計期間が締まっていないのに数字が動く: オープンな会計期間のデータは暫定値として扱われます。Claudeも「この結果は未確定です」と明示する設計なので、締め後の再確認を前提にします
- 「Enterpriseが管理するアカウント」という表示が出る: 接続しようとしたメールアドレスのドメインをEnterprise組織が検証済みで、外部アカウントからの接続を制限している状態です。自組織のClaudeアカウントでログインし直します
他の会計連携との使い分け
freee会計とのMCP連携はClaudeとfreee会計の連携 — Claude Codeで仕訳・記帳を確認する手順で扱っており、国内中小企業向けの仕訳チェックが中心です。NetSuiteは中堅からエンタープライズ規模のERPなので、対象規模も接続経路もfreeeとは別物です。
Connectors全般の種類と追加方法はClaude Connectorsとは — 種類・一覧と追加方法、コネクタが増えてきたときの読み込みモード調整はClaudeのツールアクセス設定 — Connectorsの読み込みを3モードで管理するにまとめています。組織単位でまとめて認証を通したい場合はClaude Enterpriseでコネクタを一括認証する設定手順が手順の詳細です。
まとめ
NetSuiteとClaudeの連携は、NetSuite側でのSuiteApp導入とClaude側でのディレクトリ追加という2つの作業に分かれます。管理者がMCP Standard Tools SuiteAppとCompanion SuiteAppを入れ、ユーザーがConnectorsディレクトリからNetSuiteを追加して認証すれば、標準レポートから最終手段のSuiteQLまで4段階のツールでNetSuiteデータに自然文で到達できます。書き込みを絞りたいチームは、Tool permissionsで読み取り専用に固定してから展開すると安心です。月次決算のような専門的な分析まで任せたい場合は、NetSuite Finance Analystスキルの使い方を続けて確認してください。