Skip to main content

​
Requirements

  • Node.js 18.0.0 or higher
  • npm or yarn
  • Aden API credentials (JWT token)

​
Installation

​
From Source

git clone https://github.com/acho-dev/aden-sdk-mcp.git
cd aden-sdk-mcp
npm install

​
Verify Installation

npm start -- --help

​
Claude Desktop Integration

Add the MCP server to your Claude Desktop configuration.

​
Configuration File Location

~/.config/claude/claude_desktop_config.json

​
Configuration

Add the following to your Claude Desktop config: 
{
  "mcpServers": {
    "aden-finance": {
      "command": "node",
      "args": ["/path/to/aden-sdk-mcp/bin/mcp-server.js"],
      "env": {
        "ADEN_API_BASE_URL": "https://kube.acho.io",
        "ADEN_TEAM_ID": "your-team-id",
        "ADEN_AUTH_TOKEN": "your-jwt-token"
      }
    }
  }
}
Replace /path/to/aden-sdk-mcp with the actual path where you cloned the repository.

​
Restart Claude Desktop

After updating the configuration, restart Claude Desktop to load the MCP server.

​
Standalone Usage

​
stdio Mode (Default)

ADEN_API_BASE_URL=https://kube.acho.io \
ADEN_AUTH_TOKEN=your-jwt-token \
npm start

​
HTTP Mode

For web clients or remote access: 
npm start -- --http --port 3001

​
Development

​
Run with Auto-Reload

npm run dev

​
Debug with MCP Inspector

The MCP Inspector provides a visual interface to test tools: 
npm run inspect
This opens a browser-based inspector where you can:
  • Browse available tools
  • Test tool invocations
  • View request/response payloads
  • Debug errors

​
Troubleshooting

  1. Verify the configuration file path is correct
  2. Check that the command path points to a valid Node.js installation
  3. Ensure the args path points to the correct mcp-server.js file
  4. Restart Claude Desktop completely
  1. Verify your JWT token is valid and not expired
  2. Check that ADEN_API_BASE_URL is correct
  3. Ensure your team ID is correct if using multi-tenant setup
  1. Verify network connectivity to the API server
  2. Check firewall settings
  3. Try increasing timeout values in the configuration