How to Connect Claude to Dynamics AX 2012 and 2009
An overhead view of hands typing on a laptop showing console output
Dynamics AX · Claude · Guide

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.

At a glance
  • 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.

Dynamics AXAX 2012AX 2009ClaudeMCPAIFQuery serviceERP AI agents
01

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 canOn its own, Claude cannot
Explain a trial balance export you paste inRead the live ledger
Draft variance commentary from a reportKnow whether the revaluation batch job ran
Suggest a journal from a descriptionCreate the journal in AX, or post it
Read vendor invoice PDFsMatch 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.

In ChatFin

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.

02

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.

RouteDocumented by Microsoft forReads or writesUse it for an agent?
AIF document servicesAX 2009 and AX 2012Both, per serviceYes, for writes and for entity reads
Custom services (X++ class)AX 2012BothOnly if you accept new code in the AOT
Query serviceAX 2012ReadsYes, the main read path
OData query serviceAX 2012Reads onlyYes, for simple published queries
.NET Business ConnectorAX 2009 and AX 2012BothWith care, on AX 2009 especially
Direct SQLNot an integration routeBothReads 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.

03

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 classWhat it doesOperationsFirst shipped
LedgerGeneralJournalServiceLists general journals and creates new ones, multicurrency and intercompanyC, RAX 2009 (5.0)
VendInvoiceServiceCreates and reads vendor invoices; PO lines need InventTransIdC, R, D, FAX 2012 R2
BankStmtServiceImports bank statements (advanced bank reconciliation on)C, R, D, FAX 2012 R2
CustomerTransactionServiceReturns a customer's open and closed transactionsR, FAX 2012 R2
LedgerVendorPaymentServicePayment information for a vendorRAX 2009 (5.0)
LedgerExchangeRatesServiceSends exchange rates to another subsidiaryC, RAX 4.0
BudgetTransactionServiceBudget register entriesC, R, U, D, FAX 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.

The general journal service has create and read. Posting stays a human step in AX.
04

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.

1

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.

2

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.

3

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.

4

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.

a row of data centre server racks with red and blue cabling
The MCP server runs inside the domain, next to the AOS it authenticates against.
In ChatFin

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.

05

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.

One Active Directory account for the agent, added as an AX user. Never a person's login and never a shared integration account.
A role built from the privileges it needs. Do not give it the ServiceOperation duty, which grants every service operation, and do not give it System administrator.
For Business Connector, the narrow privileges. SysCom to log on and SysComDataRead to read. Microsoft notes that SysBusinessConnectorRole allows every Business Connector operation and ignores the privileges, so leave it off.
Port restrictions. Restrict the port to the company and to authorised users on the Security FastTab, and use data policies to limit the fields it accepts.
No trusted intermediary unless you mean it. A trusted intermediary can act as any other AX user, so the agent should not be one.

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.

06

What to read first

Start with reads you can check against a number you already trust.

1

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.

2

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.

3

Open customer transactions

On AX 2012 R2 and R3 the customer transaction service returns open and closed transactions; elsewhere use a published query.

4

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.

5

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.

07

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.

Diagram: the AX general journal service offers Create and Read, with Post not listed. The agent's AX user creates an unposted journal, a named accountant reviews the lines and dimensions, then posts under their own login.
The general journal service can create and read journals but has no post operation, so a named accountant posts under their own login.
StepWhoWhere
Prepare the journal lines and the evidenceAgentOutside AX
Create the general journal, unpostedAgent userAIF, LedgerGeneralJournalService.create
Review lines, dimensions and supportNamed accountantAX journal form
PostNamed accountantAX, under their own user
Record who created, reviewed and postedAX and the agent logBoth

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.

In ChatFin

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.

08

What to test before production

Run these in a test company or a copy of production before the agent sees live data.

Company restriction. Send a request for a company the port does not allow and confirm AX rejects it.
Role scope. Ask the agent for a table outside its role, payroll for example, and confirm the query service refuses it.
Draft only. Create a journal through the port and confirm it lands unposted and that the agent user cannot post it.
Known answers. Rerun the five reads from the previous section and match each to the signed off figure.
Load. Time a full read of a large legal entity during the day and during the posting batch, and keep the slower one out of the schedule.
Audit trail. Check that AX shows the agent user as creator and the accountant as the person who posted.

If a test fails, fix the role or the port. Containment lives in AX security.

09

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.

In ChatFin

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.”

Craig Sullivan, Group VP of Product Management at NetSuite. AgentCFO podcast, episode 9

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.”

Samantha Singer-Guindi, CFO, controller and director of finance in hospitality. AgentCFO podcast, episode 8

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.

How ChatFin connects to AX

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 demo
AM
Ashok Manthena
CEO and co founder, ChatFin

Ashok Manthena is the CEO and co founder of ChatFin, an AI agent platform for enterprise finance. He works with CFOs and controllers on governed automation of the close, payables, receivables and reporting on NetSuite, Acumatica, JD Edwards, SAP, Dynamics 365 and Dynamics AX. Connect on LinkedIn.

Image credits. Header photograph: an overhead view of hands typing on a laptop showing console output, sourced from Pexels and used under the Pexels licence.
Section 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.
Get started

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.

AX 2012 query service and AIF routes named
A dedicated AX user and narrow role
Journals created unposted, posted by your team
Request a demo
Confidential & private