MCPサーバー

Nordletは、https://api.nordlet.com/mcpでModel Context Protocolを提供しています。これに接続されたAIアシスタントは、直接リクエストを行う場合と同じAPIキー、企業、スコープを使用して、APIの検索、任意の操作のリクエストスキーマの読み取り、および操作の実行を行うことができます。すべてのツール呼び出しは通常のリクエストであり、他のリクエストと同様に認証、レート制限、および課金の対象となります。また、データを変更する呼び出しは、企業の帳簿（books）を更新します。

接続

エンドポイントは Streamable HTTPに対応しており、入門ガイドで取得したBearer APIキーを使用して認証を行います。Claude Codeでの設定方法は次のとおりです。

claude mcp add --transport http nordlet https://api.nordlet.com/mcp --header "Authorization: Bearer nl_..."

他のMCPクライアントでも、同様のURLとヘッダーを使用します。*:readにスコープが制限されたキーでは、参照系の操作のみを呼び出すことができます。スコープが不足している場合、ツールはAPIの 403 エラーとして報告します。

ツール

APIのすべての操作は、次の3つのツールでカバーされます。

ツール	説明
search_operations	名前、パス、概要、または説明に含まれるキーワードから操作を検索します。オプションで特定のモジュール（sales, bank, reportsなど）内での絞り込みも可能です。クエリを指定しない場合は、モジュールの一覧を表示します。
describe_operation	指定した操作のメソッド、パス、説明、およびJSONリクエストスキーマを返します。includeResponse: trueを指定すると、200レスポンスのスキーマも追加されます。
call_operation	JSONボディを指定して操作を実行します。レスポンスボディはJSONとして返され、4xxまたは5xxのエラー応答は、ステータスとエラーエンベロープを含むツールエラーとして返されます。オプションの idempotencyKey は Idempotency-Key ヘッダーとして送信されるため、同じキーで繰り返し呼び出した場合、処理が重複して実行される代わりに最初の応答が再再生されます。

よく使用される操作については、独自のリクエストスキーマを持つ専用のツールとしても提供されているため、アシスタントはルックアップを行わずにフィールドを確認できます。対象となるツールは、partners_list、partners_get、partners_create、partners_find_or_create、catalog_items_list、sales_invoices_list、sales_invoices_get、sales_invoices_create、sales_invoices_issue、sales_invoices_send、purchases_invoices_list、purchases_invoices_create、purchases_invoices_register、bank_transactions_list、bank_transactions_import、bank_transactions_match、ledger_journal_transactions_list、reports_trial_balance、reports_financial_statements、reports_vat_summary、reports_debt_aging です。各ツールには、書き込み操作であるかどうかをクライアントに伝えるMCPアノテーション（readOnlyHint、destructiveHint）が付与されています。

操作インデックスとスキーマは、APIリファレンスやSDKと同じOpenAPI定義から生成されるため、APIに追加された操作は、そのリリースと同時に search_operations でも利用可能になります。サーバーの指示には、金額が10進数の文字列表現であること、一覧取得には page、pageSize、sort、filter が使用されること、および対象国以外の企業に対して国の申告を行うと 422 エラーが返されることなどの規約がアシスタントに向けて記載されています。

FAQ

• Q: 独自のカスタムAIクライアントからMCPサーバーに接続できますか？
  • A: はい。Streamable HTTPをサポートする任意のMCPクライアントであれば、提供されたURLとBearer認証ヘッダーを使用して接続できます。