How to Connect Claude
to Dynamics AX
Claude has no route into AX 2012 or AX 2009 by itself. Here is what AX exposes, what an MCP server sits on, and how writes stay with your team.
- Claude has no Dynamics AX connector. It needs a tool layer, such as an MCP server, running on your network as its own AX user.
- On AX 2012 the read path is the query service; writes go through AIF document services on one restricted inbound port. AX 2009 has AIF and Business Connector.
- Microsoft's Dynamics 365 ERP MCP server needs a current Dynamics 365 finance and operations release, so it does not apply to AX.
- The general journal service creates and reads journals and has no post operation, so a named person posts in AX.
- Direct SQL skips the AOS, where AX enforces its security policies. Never write through it.
To connect Claude to Dynamics AX, you put a tool layer on your own network that calls the services AX already has: AIF document services and, on AX 2012, the query service. Claude asks for a tool, the layer calls AX as a dedicated AX user with a narrow role, and anything that changes the ledger waits for a person to post it in AX.
This guide covers AX 2012 R2 and R3 and AX 2009 SP1. It names the services, the permissions and the tests, and it explains where ChatFin fits for teams that would rather not build the layer themselves. For the same question on SAP, see connecting Claude to SAP ECC.
What Claude can and cannot do with AX on its own
Claude reads what it is handed and writes text back. It has no connection to your AOS and ships no Dynamics AX connector. The Model Context Protocol, which Anthropic published in November 2024, is how Claude calls tools. Connecting it to AX means choosing the tool that sits between them and the AX user that tool runs as.
| On its own, Claude can | On its own, Claude cannot |
|---|---|
| Explain a trial balance export you paste in | Read the live ledger |
| Draft variance commentary from a report | Know whether the revaluation batch job ran |
| Suggest a journal from a description | Create the journal in AX, or post it |
| Read vendor invoice PDFs | Match them to product receipts in AX |
Microsoft's own tooling does not cover AX. Its Dynamics 365 ERP MCP server needs Dynamics 365 finance and operations at version 10.0.47, or 10.0.45 and 10.0.46 with the listed quality updates. Every AX release is past the end of extended support: AX 2009 and AX 2012 R2 on 12 April 2022, AX 2012 R3 on 10 January 2023, according to Microsoft's support notice. No Copilot, agent or MCP feature for AX turned up in Microsoft's documentation.
ChatFin is the tool layer in this picture. ChatFin connects to AX through the interfaces Microsoft documents for each release, prepares the work, and leaves posting with a named person in AX.
What Dynamics AX exposes to an outside program
AX has no read and write REST API of the kind Dynamics 365 has. What it does have is older, Windows authenticated and processed on the AOS, and it differs between AX 2009 and AX 2012.
| Route | Documented by Microsoft for | Reads or writes | Use it for an agent? |
|---|---|---|---|
| AIF document services | AX 2009 and AX 2012 | Both, per service | Yes, for writes and for entity reads |
| Custom services (X++ class) | AX 2012 | Both | Only if you accept new code in the AOT |
| Query service | AX 2012 | Reads | Yes, the main read path |
| OData query service | AX 2012 | Reads only | Yes, for simple published queries |
| .NET Business Connector | AX 2009 and AX 2012 | Both | With care, on AX 2009 especially |
| Direct SQL | Not an integration route | Both | Reads from a replica at most; never writes |
On AX 2012, integration ports replaced the AIF endpoints of AX 2009. A basic inbound port is a WCF endpoint on the AOS; an enhanced port adds the HTTP, NetTCP, MSMQ and file system adapters, data policies and IIS hosting. Microsoft's own AX 2009 material describes AIF as XML document exchange with create, read, update and delete operations added in that release.
The query service runs a query defined in the AOT, a query built in code, or an X++ query builder class, and returns a dataset in pages. Microsoft states that it "respects any security that is implemented for the calling user". The OData query service publishes AOT queries that you register as document data sources. It does not support OData filters or any update, and returns 1,000 rows a page by default.
Direct SQL gets proposed because it is quick to build. AX enforces its record security policies in the AOS, and a SQL login never passes through it, so a SQL read returns rows the AX role would hide. A SQL write also skips X++ validation and the RecId sequence; a partner write up on SystemSequences describes the duplicate record errors that follow.
The AIF services a finance agent uses
AX 2012 ships dozens of standard document services. These are the ones a finance agent touches. Operations are as Microsoft lists them: C create, R read, U update, D delete, F find.
| Service class | What it does | Operations | First shipped |
|---|---|---|---|
| LedgerGeneralJournalService | Lists general journals and creates new ones, multicurrency and intercompany | C, R | AX 2009 (5.0) |
| VendInvoiceService | Creates and reads vendor invoices; PO lines need InventTransId | C, R, D, F | AX 2012 R2 |
| BankStmtService | Imports bank statements (advanced bank reconciliation on) | C, R, D, F | AX 2012 R2 |
| CustomerTransactionService | Returns a customer's open and closed transactions | R, F | AX 2012 R2 |
| LedgerVendorPaymentService | Payment information for a vendor | R | AX 2009 (5.0) |
| LedgerExchangeRatesService | Sends exchange rates to another subsidiary | C, R | AX 4.0 |
| BudgetTransactionService | Budget register entries | C, R, U, D, F | AX 2012 |
No document service in Microsoft's table offers a post operation. The general journal service creates and reads journals, so a journal an agent creates waits in AX until somebody with the right to post it does so. The services marked AX 2012 R2 are not on AX 2012 RTM or AX 2009, so check the Services node in your own AOT first.
What an MCP server for Dynamics AX sits on
An MCP server for AX is a small program on your network that exposes a handful of tools to Claude and turns each call into an AX service call. It has to run inside the domain, because the query service, AIF over NetTCP and Business Connector all authenticate with Windows credentials against the AOS.
Reads go to the query service
Publish the AOT queries the agent needs, such as open vendor transactions by legal entity, and let the server call them by name. Use value based paging and keep page sizes small. On AX 2009, use document service read and find, or Business Connector with read privileges only.
Writes go to one enhanced inbound port
Create a port that exposes only the operations you approve, for example LedgerGeneralJournalService.create and nothing else. Restrict it to the company and to the agent's user.
Every tool returns its evidence
The server returns the query name, legal entity, period, filter and row count with every figure, so a person can rerun the read in AX.
Nothing goes through SQL writes
If the server ever needs a table no service covers, ask for an AOT query or a custom service. A write that skips the AOS skips the business logic.
ChatFin runs this layer for you: ChatFin connects through the AX 2012 query service and AIF document services, or through AIF and Business Connector on AX 2009, under an AX user your administrator creates.
The AX user, role and port to set up
AX 2012 services run under role based security. The submitting user must be an authenticated AX user, and every service operation maps to an entry point privilege (Microsoft's example is SalesSalesOrderServiceCreate). That gives you the controls.
AX 2009 has no roles or duties. Security there is user groups and security keys, set per company, and record level security only applies where code calls it. Expect more work to build a narrow group on AX 2009 than a role on AX 2012.
Then licensing. Microsoft's AX 2012 R3 licensing guide says any user who accesses the solution directly or indirectly must be licensed and that multiplexing does not reduce the count. Ask your partner how that treats an agent account before go live.
What to read first
Start with reads you can check against a number you already trust.
Trial balance by legal entity for a closed period
Compare it with the report your team signed off. Any difference is a query or permission problem, and it is cheaper to find now.
Open vendor transactions
Tie the total to the AP ageing the payables team uses. Then read pending vendor invoices, which the Dynamics AX payables page works by cause.
Open customer transactions
On AX 2012 R2 and R3 the customer transaction service returns open and closed transactions; elsewhere use a published query.
Batch job history
AX keeps a history for every batch job. Read it before any figure so the agent knows whether posting or revaluation had finished.
Posted financial dimension combinations
Count the combinations actually posted against what the setup allows. It shows how far the reports and the ledger have drifted.
Schedule large reads away from the posting window. Microsoft's documentation on load balancing states that service traffic in an AOS cluster goes to the first AOS instance unless Windows Network Load Balancing is set up, so a heavy read at month end competes with posting on that one server.
How writes go through approval
The approval sits in AX itself. The agent creates a draft, a named person reviews it with its evidence, and that person posts it in AX under their own login.

| Step | Who | Where |
|---|---|---|
| Prepare the journal lines and the evidence | Agent | Outside AX |
| Create the general journal, unposted | Agent user | AIF, LedgerGeneralJournalService.create |
| Review lines, dimensions and support | Named accountant | AX journal form |
| Post | Named accountant | AX, under their own user |
| Record who created, reviewed and posted | AX and the agent log | Both |
This keeps segregation of duties inside AX, where your auditors already test it. The agent's role holds the create privilege and leaves posting out, so the person who posts is the one AX records. Vendor invoices follow the same pattern through VendInvoiceService on AX 2012 R2 and R3.
ChatFin prepares the entry and its evidence, creates it in AX only through the approved service operation, and a named person in your team posts it. ChatFin has no posting rights in AX.
What to test before production
Run these in a test company or a copy of production before the agent sees live data.
If a test fails, fix the role or the port. Containment lives in AX security.
If a Dynamics 365 migration is coming
The same work that connects an agent to AX is the work a migration will repeat in part. Microsoft's AX 2012 upgrade runs from R2 or R3 and brings full transactional history, and AX 2009 moves through the Data migration tool. The query and service routes change entirely; the review steps, the tests and the approval rule do not.
If your cutover is dated and a few months away, build on Dynamics 365 instead and use the Dynamics 365 Claude guide. If it is further out, start with reads on AX now. The Dynamics AX AI agents pillar covers the close, payables, receivables and FP&A, and the AX comparison page has four tests to put to any vendor, ChatFin included.
ChatFin reads AX 2009 and AX 2012 today and keeps its rules and checks outside the ERP, so ChatFin carries them to Dynamics 365 when you move.
Can Claude connect to Dynamics AX at all?
Yes, but not directly. Claude has no Dynamics AX connector, so a tool layer on your network sits between Claude and AX and calls the services AX already has. On AX 2012 that means the query service for reads and AIF document services for writes. On AX 2009 it means AIF and Business Connector.
Microsoft's Dynamics 365 ERP MCP server is not an option for AX, because it needs a current Dynamics 365 finance and operations release. A team still on AX therefore builds a small MCP server or buys one, and the choice comes down to who will keep it running as AX services and security roles change.
Craig Sullivan, Group VP of Product Management at NetSuite, talks about the opportunity cost of building software yourself.
“I think in my mind it comes down to what's the opportunity cost of worrying about perfecting and optimizing the software that you could choose to build for yourself as opposed to using those cycles, whether they be AI cycles or human brain thought cycles on actually thinking about how to optimize your business for success.”
AX finance tasks a Claude tool layer can serve
The services table above shows what AX exposes. These tasks fit inside it, with posting left to a person in AX.
- Open vendor items by entity. An AP lead asks for open vendor transactions in one legal entity and gets them from a published query, with the query name and row count so the read can be repeated in AX.
- Bank statement imports. A treasury analyst loads a statement file through the bank statement service, with advanced bank reconciliation on, and works the lines AX did not match.
- Journal drafts waiting for posting. The agent creates a general journal through the journal service. It sits in AX until someone with posting rights reviews and posts it.
- Customer balance questions. A credit controller asks for a customer's open and closed transactions before a collections call.
- Excel models from AX exports. An analyst pastes a ledger export into Claude and asks it to build the workbook and charts, with no connection to AX needed.
- Budget register checks. A planner reads back budget register entries for a department and compares them with actuals before a forecast meeting.
Samantha Singer-Guindi, a CFO, controller and director of finance in hospitality, talks about using Claude to build Excel models.
“I really do use it heavily to build out models. So I love using it for, help me build out this type of Excel file. Help me create this type of chart. ... These are things that usually take years of practice and I don't have the coding background to build out these macros and stuff like that.”
Quick Answers on Claude and Dynamics AX
Can Claude connect to Dynamics AX 2012?
Not on its own. Claude needs a tool layer, such as an MCP server, that calls AX 2012 through the query service for reads and AIF document services for writes, running as a dedicated AX user with a narrow role.
Is there an MCP server for Dynamics AX?
Microsoft's Dynamics 365 ERP MCP server needs a current Dynamics 365 finance and operations release, so it does not apply to AX. For AX you build a small server yourself or use a provider that runs one.
How do I connect Claude to Dynamics AX 2009?
On AX 2009 the routes are AIF document services and the .NET Business Connector. Keep the agent's user to read privileges where you can, and run the tool layer inside the domain, since these routes use Windows credentials.
Can Claude post journals in Dynamics AX?
The general journal service creates and reads journals but has no post operation. A journal the agent creates waits in AX until a person with posting rights reviews and posts it.
Why not let Claude query the AX database directly?
Direct SQL bypasses the AOS, where AX enforces its security policies, so reads can return rows the user's role would hide, and writes skip X++ validation. Use AOT queries or document services instead.
Questions AX teams ask
Can Claude connect to Dynamics AX 2012?
Yes, through a tool layer. Claude calls an MCP server, and the server calls the AX 2012 query service for reads and an AIF inbound port for writes, as a dedicated AX user with a narrow role. Claude has no built in AX connector.
Is there an MCP server for Dynamics AX?
Not from Microsoft. Microsoft's Dynamics 365 ERP MCP server requires Dynamics 365 finance and operations at 10.0.45 or later with the listed quality updates. For AX you run your own server on the AIF services and query service, or use a product such as ChatFin that connects through them.
Can an AI agent post journals in AX?
It should not, and the standard service does not offer it. LedgerGeneralJournalService lists create and read only, so the agent creates an unposted journal and a named person posts it in AX under their own user.
Is it safe to let Claude query the AX SQL database?
Reading a replica through a login your DBA scopes is common, but it skips the AOS, so the agent can see rows its AX role would hide. Writing through SQL also skips X++ validation and RecId allocation. Use the query service where you can.
Does the agent's AX account need a licence?
Microsoft's AX 2012 R3 licensing guide says direct and indirect access both need a licence and that multiplexing does not reduce the count. How that applies to an agent account depends on your agreement, so ask your partner.
What about AX 2009?
Use AIF document services and .NET Business Connector; Microsoft documents the query service and OData query service for AX 2012. Security on AX 2009 is user groups and security keys, so scoping the agent takes more care. ChatFin connects through AIF and Business Connector there.
Reads through AX services, posting by your team.
ChatFin connects to AX 2012 through the query service and AIF document services, and to AX 2009 through AIF and Business Connector, under an AX user your administrator creates and scopes.
ChatFin prepares journals and invoices with their evidence, creates them unposted through the one service operation you approve, and a named person posts in AX.
Book a demoSection photograph: a row of data centre server racks with red and blue cabling, sourced from Pexels and used under the Pexels licence.
All images are served from the Pexels content network. No third party product screenshots, vendor logos or licensed media are used on this page.
See the reads on your own AX.
Bring a closed period trial balance and your AP ageing. We will run the same reads through ChatFin and show you the evidence behind each figure.