Generic API MCP Server

Connect Claude Desktop to Aras Innovator PLM via OAuth 2.0!

This Model Context Protocol (MCP) server enables Claude Desktop to interact with Aras Innovator using modern OAuth 2.0 authentication and OData REST APIs, allowing you to query PLM data, create items, and call methods directly from your AI assistant.

- 🔐Secure OAuth 2.0 authenticationwith Aras Innovator 14+
- 📊Query PLM datausing OData REST endpoints
- ✍️Create new items(Parts, Documents, etc.) directly from Claude
- 🔧Call Aras server methodsand custom endpoints
- 📋Access listsand configuration data
- 🛡️Enterprise-grade securitywith bearer token authentication

- Windows:Download frompython.org
- macOS/Linux:brew install pythonorsudo apt install python3 python3-pip

- Download fromclaude.ai- no subscription required!

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

# 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

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

💡Replace the pathwith your actual installation directory!

The server should start without any JSON parsing errors.

Test in Claude Desktop:Restart Claude Desktop and try:

- "Test my API connection"
- "Get all Parts from the database"
- "Show me the available Document types"

This agent usesOAuth 2.0 Resource Owner Password Credentials Grantfor secure authentication with Aras Innovator 14+. The authentication flow:
- Token Request:https://your-server/oauthserver/connect/token
- Scope:openid Innovator offline_access
- Client ID:IOMApp(default Aras client)
- Grant Type:password
- Required:username,password,database

You: "Test my API connection" Claude: ✅ Successfully authenticated with API! Bearer token obtained and ready for API calls. Server URL: https://your-server.com/YourDatabase You: "Get all Parts where item_number starts with 'P-'" Claude: Retrieved 25 Parts matching your criteria... You: "Create a new Document with name 'User Manual v2'" Claude: Successfully created Document with ID A1B2C3D4...

✅ v1.1.0 - OAuth 2.0 & JSON Parsing Fixes

- Fixed: "Unexpected token 'A', 'API MCP Se'... is not valid JSON" error
- Added: Proper OAuth 2.0 authentication withrequests-oauthlib
- Added: Database parameter requirement for Aras authentication
- Fixed: All print statements redirected to stderr to prevent stdout contamination
- Updated: OData endpoint support (/Server/Odata)
- Added: Proper HTTP headers for Aras REST API

- Verify your Aras server supports OAuth 2.0 (Aras 14+)
- Check credentials and database name in.env
- Ensure user has API access permissions

🔐 "Missing database parameter" error?

- AddARAS_DATABASE=YourDatabaseNameto your.envfile

- Restart Claude Desktop after config changes
- Check file paths inclaude_desktop_config.json

- ✅ Fixed in v1.1.0! Update to latest version

Claude Desktop ↓ JSON-RPC MCP Server (stdio) ↓ OAuth 2.0 Aras Innovator ↓ OData REST API PLM Database

Found a bug or want to add features? We welcome contributions! Please check our issues or submit a pull request.

- Aras Developer Documentation
- Model Context Protocol
- Aras OAuth 2.0 Guide

MIT License - seeLICENSEfile for details.

A lightweight server exposing Axone's capabilities through the Model-Context Protocol.