home / mcp / aaro erp mcp server

AARO ERP MCP Server

Claude MCP Server

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "aaroyazilim-aaro-erp-mcp-server": {
      "command": "npx",
      "args": [
        "aaro-erp-mcp-server"
      ]
    }
  }
}

You can run the AARO ERP MCP Server to access the AARO ERP API, manage tokens, and perform core ERP operations through Claude Desktop. This server connects your Claude Desktop workflows to AARO ERP, enabling token handling, data lookups, and action execution from the MCP client.

How to use

Use the MCP server from Claude Desktop to access ERP data and perform common operations such as listing stock, creating records, handling invoices, and managing accounts. You use the MCP client inside Claude Desktop to trigger the available tools, which communicate securely over HTTPS with token-based authentication. Start by ensuring your MCP server is configured and accessible, then enable the AARO ERP tools in Claude Desktop to perform tasks directly from the UI.

How to install

Prerequisites you need before running the MCP server:

Node.js version 18 or newer
Claude Desktop application
An AARO ERP account with access permissions

Install and run using NPX directly. The server package is pulled and executed on demand.

Configure Claude Desktop to load the MCP server. Add a MCP server entry with the following configuration in the Claude Desktop MCP settings (Windows, macOS, and Linux paths are shown):

{
  "mcpServers": {
    "aaro-erp": {
      "command": "npx",
      "args": ["aaro-erp-mcp-server"],
      "disabled": false
    }
  }
}

Claude Desktop configuration steps

Windows path: %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

macOS path: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

Linux path: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

Add the MCP server entry shown above. Save the file and close Claude Desktop if it’s running, then restart Claude Desktop to apply changes.

Restart Claude Desktop

Close Claude Desktop completely and reopen it to apply the new MCP server configuration.

Quick start completeness

After setup, Claude Desktop will automatically download the necessary MCP package on the first use. You can begin using the AARO ERP tools to manage tokens, fetch data, and perform ERP actions from the Claude Desktop interface.

Security

The server uses Bearer token authentication and HTTPS for secure communication. Errors are captured and reported, and browser automation features include built-in security protections.

Troubleshooting

If you encounter issues, check the following: - Ensure Node.js is v18+ and Claude Desktop is installed correctly. - Verify the MCP settings file path and JSON structure. - Restart Claude Desktop after changes. - Confirm the AARO ERP account is active and has the required permissions.

Developer notes

This MCP server leverages TypeScript for type safety, Puppeteer for browser automation, Axios for HTTP requests, and the MCP SDK for Claude Desktop integration. It is designed with a modular structure to allow easy extension.

Available tools

erp_token_al

Token retrieval and cache management for authentication.

erp_token_sil

Token cache deletion to remove stored credentials.

erp_stok_listele

List stocks with filtering options.

erp_stok_olustur

Create a new stock card.

erp_stok_hareketleri_listele

List stock movements.

erp_seri_lot_listele

Track serials and lot details.

erp_barkod_listele

Manage barcodes.

erp_cari_listele

List customer accounts.

erp_cari_olustur

Create a new customer account.

erp_siparis_listele

List order movements.

erp_fatura_listele

List invoice movements.

erp_depo_listele

Manage warehouses.

erp_doviz_listele

List exchange rates.

erp_kasa_listele

List cash register movements.

erp_banka_listele

List bank accounts.

erp_personel_listele

List personnel information.

erp_dekont_listele

List accounting vouchers.

erp_api_cagir

General API call endpoint.