alrm-mcp

MCPサーバー for AL ID Range Manager.

AIコーディングエージェントが、ALRM VS Code extensionと同じ方法でALオブジェクトIDを予約できるようにします。エージェントが新しいALオブジェクトを作成しようとするとき、new_object を呼び出すと、Business Centralの共有ALRMデータベースが名前を検証し、次に空いているオブジェクトIDを返します。これにより、同じ拡張機能で作業している全員の間でIDが一意に保たれます。

ツール

new_object

新しいALオブジェクトを登録し、割り当てられたIDを返します。

オブジェクトIDをテキストとして返します（例: 50061）。同じ名前で再度呼び出すと、新しいIDを割り当てるのではなく、同じIDが返されます。

Related MCP server: Dynamics 365 Business Central Admin MCP Server

要件

• Node.js 20 以降

• ALRM拡張機能がインストールされたBusiness Central環境

• その環境にサインインする権限（認証を参照）

設定

{
  "mcpServers": {
    "alrm-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "alrm-mcp@latest"],
      "env": {
        "BC_TENANT": "{tenant}",
        "BC_ENVIRONMENT": "{environment}",
        "BC_COMPANY": "{company}"
      }
    }
  }
}

Claude Codeでは、1つのコマンドで追加できます:

claude mcp add alrm-mcp \
  --env BC_TENANT=contoso.com \
  --env BC_ENVIRONMENT=Production \
  --env BC_COMPANY=00000000-0000-0000-0000-000000000000 \
  -- npx -y alrm-mcp@latest

環境変数

3つすべて必須です。サーバーは、不足している変数を示すメッセージとともに即座に終了します。

これらはMCPクライアントの env ブロックからのみ読み取られます。.env ファイルのサポートはありません。サーバーは通常、シェルからではなく クライアントによって起動されるためです。

2つのオプション変数を使用すると、デフォルトのパブリッククライアントの代わりに、独自のEntraアプリ登録をサーバーに指定できます。

認証

最初のツール呼び出しで、OAuth 2.0デバイスコードフローを使用してサインインします。

1. ブラウザタブが https://microsoft.com/devicelogin で開きます。

2. デバイスコードがクリップボードにコピーされ、クリップボードやブラウザが利用できない場合に備えて、サーバーのstderrにも出力されます。

3. コードを貼り付け、サインインを完了すると、ツール呼び出しが続行されます。

その後、トークンキャッシュはオペレーティングシステムの資格情報ストア（macOSではKeychain、WindowsではDPAPI、LinuxではSecret Service/libsecret）に保存され、ホームディレクトリに .alrm-cache.json という小さなインデックスファイルが置かれます。以降のセッションでは、サーバーやエディタの再起動を含め、サイレントに再利用されるため、リフレッシュトークンが期限切れになるまで（約90日間の非アクティブ）ブラウザが再度表示されることはありません。

サインアウトするには、.alrm-cache.json を削除し、資格情報ストアから alrm-mcp エントリを削除します。macOSの場合:

rm ~/.alrm-cache.json
security delete-generic-password -s alrm-mcp -a alrm-mcp

logout コマンドはまだありません。

プラットフォームに関する注意

Linuxでは、サーバーはトークンを平文で保存するフォールバックを拒否します。Secret Serviceが利用できないヘッドレスマシンでは、暗号化されていないトークンキャッシュを静かに書き込むのではなく、サインインが失敗します。

トラブルシューティング

サーバーが起動しない / クライアントが CONNECTION_CLOSED を報告する。 ほとんどの場合、環境変数の欠落またはスペルミスです。直接実行して実際のエラーを確認してください。MCPクライアントはエラーを飲み込みます:

BC_TENANT=contoso.com BC_ENVIRONMENT=Production BC_COMPANY=... npx -y alrm-mcp@latest

正常なサーバーは MCP server running on stdio を出力して待機します。

Extension {id} not found! app.json の appId が、この会社のALRMデータベースに登録されていません。VS Code拡張機能またはBusiness Centralで直接、拡張機能を最初に登録してください。

予期せずブラウザが開いた。 それは上記のサインインです。毎回ではなく一度だけ発生するはずです。繰り返す場合は、トークンキャッシュが永続化されていません。stderr出力で、保存されたサインインの再利用に関するメッセージを確認してください。

開発

git clone https://github.com/hiimnit/alrm-mcp.git
cd alrm-mcp
npm install
npm run build

次に、公開パッケージの代わりにローカルビルドをMCPクライアントに指定します:

{
  "mcpServers": {
    "alrm-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/alrm-mcp/dist/index.js"],
      "env": {
        "BC_TENANT": "...",
        "BC_ENVIRONMENT": "...",
        "BC_COMPANY": "..."
      }
    }
  }
}

npm run typecheck は出力なしで型をチェックします。npm run build は最初に dist/ をクリーンアップし、npm pack と npm publish でも自動的に実行されます。