Setup

Get Your Aha! Credentials

API Token

1. Log in to your Aha! workspace
2. Go to Settings > Personal > Developer > API
3. Generate a new API token
4. Copy the token (it won't be shown again)

Domain

Your Aha! subdomain is the first part of your workspace URL:

• If your workspace is at mycompany.aha.io, your domain is mycompany

Configure Credentials

Option 1: Environment Variables

export AHA_DOMAIN="your_subdomain"
export AHA_API_TOKEN="your_api_token"

Option 2: Command-Line Flags

aha-mcp-server --subdomain mycompany --api-key your-api-key

Option 3: Vault-Backed Credentials

For production use, store credentials in a vault:

# 1Password
export OP_SERVICE_ACCOUNT_TOKEN="ops_..."
aha-mcp-server --vault op://MyVault --credentials-name aha

# Bitwarden
export BW_ACCESS_TOKEN="..."
export BW_ORGANIZATION_ID="..."
aha-mcp-server --vault bw://org-id --credentials-name aha

# Keeper
export KSM_TOKEN="US:..."
aha-mcp-server --vault keeper:// --credentials-name aha

See Credentials for detailed configuration options.

Test Your Setup

# Test with CLI mode
aha-mcp-server search-documents "product roadmap" --subdomain mycompany --api-key your-key