Nordlet

← ドキュメント / ガイド

ClaudeとNordletの連携

Nordletアカウントの作成、ログインによるClaudeの接続、および接続解除の手順をステップバイステップで解説します。

このガイドは、ClaudeにNordletの帳簿データを処理させたい方向けの手順を説明しています。Claudeは Nordlet MCPサーバー (https://api.nordlet.com/mcp) に接続します。接続の承認はNordletのページで一度行うだけであり、APIキーを手動でコピーする必要はありません。

1. Nordletアカウントの作成

  1. app.nordlet.com を開き、メールアドレスを入力します。
  2. 利用規約、プライバシーポリシー、およびデータ処理契約 (DPA) に同意します。Nordletからログイン用のリンクが送信されます。このリンクの有効期限は15分で、1回のみ使用可能です。パスワードの設定はありません。
  3. メール内のリンクを開きます。無料トライアルから開始できる定額プラン、または初回チャージによる従量課金プランのいずれかを選択します。
  4. 会社情報を入力して作成します。会社名、国、登録番号、およびVAT番号 (VAT identification number) を指定してください。動作を試す場合は、サンドボックス会社 (Sandbox company) にチェックを入れます。サンドボックスにはテストデータが保持され、いつでも削除できます。

1つのユーザーアカウントで複数の会社に所属することが可能です (ご自身の会社や、オーナーから招待された会社など)。各会社におけるご自身の権限 (オーナー、管理者、会計担当者、マネージャー、開発者、または閲覧者) に応じて、実行可能な操作が決まります。Claudeも同様の権限を引き継ぎます。

2. Claudeの接続

  1. Claude側で、アドレス https://api.nordlet.com/mcp を指定してカスタムコネクタを追加します。認証情報は空欄のままにします。
  2. ClaudeからNordletのページが開きます。未ログインの状態である場合、Nordlet側でメールアドレスの入力を求められ、ログイン用リンクが送信されます。同じブラウザでそのリンクを開くと、該当のページに戻ります。
  3. ページには、アクセスを要求しているアプリ名と、リダイレクト先のアドレスが表示されます。内容を確認し、許可 (Allow) を選択します。拒否 (Deny) を選択すると、アクセス権が付与されないまま元の画面に戻ります。
  4. Claudeの画面に戻り、コネクタの接続が完了します。

Claudeは自身でアクセスの更新を行います。アクセストークンの有効期限は1時間ですが、Claudeがユーザーの介入なしに自動で新しいトークンに更新します。

3. Claude Codeの接続

以下のコマンドを実行します。

claude mcp add --transport http nordlet https://api.nordlet.com/mcp

次に、Claude Code内で /mcp を実行し、nordlet サーバーの認証を選択します。ブラウザが開き、ステップ2と同様のNordletのページが表示されます。許可をクリックすると、ブラウザからお使いのコンピュータ上のClaude Codeへと自動的に戻ります。

4. 会社データの処理

1つの接続で、所属するすべての会社を操作できます。Claudeはまず所属会社の一覧を取得し、各リクエスト内で対象の会社名を指定します。「UAB Pavyzdysでこの請求書を発行して」のように、会社名を指定して指示を出してください。新しい会社に追加された場合、Claudeはその会社ですぐに作業を開始できます。会社から外された場合、Claudeはその会社へのアクセスを失います。

Claudeが行うすべての呼び出しは通常のリクエストとして扱われ、他のリクエストと同様に使用量がカウントされます。また、Claudeによって行われた変更は監査ログ (audit log) に記録されます。

5. 接続の解除

  1. Nordletにログインし、[アカウント] (Account) -> [開発者] (Developers) の順に開きます。アプリ名 (例: "Claude") の項目にAPIキーとして接続が表示されます。
  2. 取り消し (Revoke) を選択します。これにより、すべての会社においてClaudeのアクセス権が即座に失われます。

再度接続を行うには、ステップ2を再度実行してください。

APIキーを使用する場合

オーナー、管理者、および開発者は、[アカウント] (Account) -> [開発者] (Developers) からAPIキーを作成し、HTTPヘッダーとして送信することも可能です。MCPサーバー のドキュメントをご参照ください。