Aras Innovator

You can securely connect Claude Desktop to Aras Innovator using OAuth 2.0 and control Aras data from your AI assistant. This MCP server enables querying PLM data, creating items, and invoking server methods through Claude, all with bearer token authentication and OData REST APIs.

How to use

Interact with Aras Innovator from Claude to query data, create new items like Parts or Documents, call server methods, and fetch lists and configuration data. Start by authenticating with OAuth 2.0, then issue natural language commands to perform common tasks such as listing parts, retrieving documents, or creating a new item. Claude will translate your requests into authenticated API calls and present results back to you.

How to install

Prerequisites: ensure you have Python 3.8 or newer, and Python’s package manager available on your system.

Step 1: Clone the project and install dependencies.

git clone https://github.com/DaanTheoden/aras-claude-agent.git
cd aras-claude-agent
pip install -r requirements.txt

Step 2: Configure your Aras connection by creating a .env file in the project root and adding your credentials and connection details.

# Aras Innovator OAuth 2.0 Configuration
API_URL=https://your-aras-server.com/YourDatabase
API_USERNAME=your-aras-username
API_PASSWORD=your-aras-password
ARAS_DATABASE=YourDatabase

# Optional Configuration
API_TIMEOUT=30
API_RETRY_COUNT=3
API_RETRY_DELAY=1
LOG_LEVEL=INFO

Step 3: Add the MCP server config to Claude Desktop by editing the client configuration to include the local stdio server entry.

{
  "mcpServers": {
    "api-server": {
      "command": "py",
      "args": ["C:/path/to/your/aras-claude-agent/main.py"]
    }
  }
}

Step 4: Start the server in a terminal to verify it runs correctly.

pip install -r requirements.txt
python main.py

Step 5: Restart Claude Desktop and test the integration using available phrases such as “Test my API connection” or “Get all Parts from the database.”

Configuration and security notes

The server uses OAuth 2.0 with the Resource Owner Password Credentials grant to obtain an access token for Aras Innovator 14+. Ensure the Aras server is configured to support OAuth 2.0 and that the user account has API permissions.

Environment variables you provide control how the server connects to Aras and how long it waits for responses. Keep credentials secure and avoid sharing the .env file.

Troubleshooting

OAuth authentication failing? Verify that your Aras server supports OAuth 2.0 (14+), check the .env credentials and database name, and ensure the user has API access permissions.

Missing database parameter? Add ARAS_DATABASE to your .env file and retry.

Claude not recognizing tools? Restart Claude Desktop after config changes and confirm the config file paths.

JSON parsing issues? Ensure you are using the latest server version which fixes JSON handling and keeps authentication flow reliable.

Architecture overview

Claude Desktop communicates with the MCP server via JSON-RPC over stdio. The MCP server handles OAuth 2.0 authentication, calls to Aras Innovator’s OData REST API, and returns data or confirmation back to Claude.

Examples of typical conversations

You: “Test my API connection”\nClaude: Successfully authenticated with API and ready for requests.\n\nYou: “Get all Parts where item_number starts with 'P-’”\nClaude: Retrieved matching Part records from Aras Innovator.

Available tools

test_api_connection

Test OAuth 2.0 authentication and connectivity to Aras Innovator API.

api_get_items

Query Aras OData endpoints to retrieve items such as Part or Document records.

api_create_item

Create new Aras items like Part or Document in the database.

api_call_method

Call Aras server methods and custom endpoints from Claude.

api_get_list

Fetch Aras list values such as Part categories.