- Explore MCP Servers
- aras-claude-agent
Aras Claude Agent
What is Aras Claude Agent
The Generic API MCP Server is a bridge enabling Claude Desktop to interact with any REST API. It allows users to perform various actions like querying data, creating items, and executing methods directly from the AI assistant, simplifying workflows and enhancing productivity.
Use cases
Users can leverage the API MCP Server to test API connections, fetch data from endpoints, create new items on the fly, call specific API methods, and access predefined lists. It is useful in scenarios where data retrieval and manipulation through APIs is required, such as managing user databases or integrating different services.
How to use
To set up, clone the repository, install dependencies, and configure a ‘.env’ file with your API credentials. Add the server to Claude Desktop’s configuration file, specifying the path to the main script. After installation, test the connection and perform queries directly through Claude by asking relevant questions.
Key features
Key features include secure API connection testing, data querying from RESTful endpoints, item creation via the API, method invocation, and list access. These features enable seamless interaction with various API functionalities while facilitating convenient AI-driven operations.
Where to use
This API MCP Server can be used in environments where Claude Desktop is installed and where there is a need to interact with REST APIs, such as in corporate settings for data management, software development projects requiring backend integration, or any application leveraging external data sources.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Overview
What is Aras Claude Agent
The Generic API MCP Server is a bridge enabling Claude Desktop to interact with any REST API. It allows users to perform various actions like querying data, creating items, and executing methods directly from the AI assistant, simplifying workflows and enhancing productivity.
Use cases
Users can leverage the API MCP Server to test API connections, fetch data from endpoints, create new items on the fly, call specific API methods, and access predefined lists. It is useful in scenarios where data retrieval and manipulation through APIs is required, such as managing user databases or integrating different services.
How to use
To set up, clone the repository, install dependencies, and configure a ‘.env’ file with your API credentials. Add the server to Claude Desktop’s configuration file, specifying the path to the main script. After installation, test the connection and perform queries directly through Claude by asking relevant questions.
Key features
Key features include secure API connection testing, data querying from RESTful endpoints, item creation via the API, method invocation, and list access. These features enable seamless interaction with various API functionalities while facilitating convenient AI-driven operations.
Where to use
This API MCP Server can be used in environments where Claude Desktop is installed and where there is a need to interact with REST APIs, such as in corporate settings for data management, software development projects requiring backend integration, or any application leveraging external data sources.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Content
🚀 Aras Innovator Claude Agent
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.
✨ What can you do?
- 🔐 Secure OAuth 2.0 authentication with Aras Innovator 14+
- 📊 Query PLM data using OData REST endpoints
- ✍️ Create new items (Parts, Documents, etc.) directly from Claude
- 🔧 Call Aras server methods and custom endpoints
- 📋 Access lists and configuration data
- 🛡️ Enterprise-grade security with bearer token authentication
📋 Prerequisites
🐍 Python 3.8+
- Windows: Download from python.org
- macOS/Linux:
brew install python
orsudo apt install python3 python3-pip
🤖 Claude Desktop (free!)
- Download from claude.ai - no subscription required!
🏢 Aras Innovator 14+ with OAuth 2.0
- Aras Innovator server with OAuth 2.0 endpoints enabled
- Valid Aras user credentials with API permissions
- Database access permissions
🎯 Quick start
1️⃣ Clone & install
git clone https://github.com/DaanTheoden/aras-claude-agent.git
cd aras-claude-agent
pip install -r requirements.txt
2️⃣ Configure your Aras connection
Create a .env
file in the project root:
# 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
💡 Copy from
env_example.txt
and update with your Aras credentials
3️⃣ Add to Claude Desktop
Edit your Claude Desktop config file:
📁 Windows: %APPDATA%\Claude\claude_desktop_config.json
📁 macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"api-server": {
"command": "py",
"args": [
"C:/path/to/your/aras-claude-agent/main.py"
]
}
}
}
💡 Replace the path with your actual installation directory!
4️⃣ Test your setup!
Verify installation:
python main.py
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”
🛠️ Available tools
Tool | Description | What You Can Ask | Example Endpoint |
---|---|---|---|
test_api_connection |
Test OAuth 2.0 authentication | “Test my API connection” | N/A |
api_get_items |
Query Aras OData | “Get all Parts” | Part , Document |
api_create_item |
Create new Aras items | “Create a new Part” | Part , Document |
api_call_method |
Call Aras server methods | “Call method GetItemsInBOM” | Method names |
api_get_list |
Get Aras list values | “Show Part categories” | List IDs |
🔐 OAuth 2.0 Authentication
This agent uses OAuth 2.0 Resource Owner Password Credentials Grant for 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
💬 Example conversations
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...
🔧 Recent Fixes & Updates
✅ 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 with
requests-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
🛠️ Troubleshooting
🔗 OAuth authentication failing?
- 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?
- Add
ARAS_DATABASE=YourDatabaseName
to your.env
file
🤖 Claude not finding tools?
- Restart Claude Desktop after config changes
- Check file paths in
claude_desktop_config.json
🐍 JSON parsing errors?
- ✅ Fixed in v1.1.0! Update to latest version
🏗️ Architecture
Claude Desktop ↓ JSON-RPC MCP Server (stdio) ↓ OAuth 2.0 Aras Innovator ↓ OData REST API PLM Database
🤝 Contributing
Found a bug or want to add features? We welcome contributions! Please check our issues or submit a pull request.
📚 Learn More
📄 License
MIT License - see LICENSE file for details.
Dev Tools Supporting MCP
The following are the main code editors that support the Model Context Protocol. Click the link to visit the official website for more information.