AI Assistant Setup

Prerequisites

You will need an Aplas API key. To generate one:

Log in to Aplas and open Config → API.
Click Create API Key and copy the generated key.

Keep your API key secure

Your API key provides access to your organization's data. Do not share it publicly or commit it to version control.

Regional endpoint

Aplas is hosted in three regions and the MCP server lives at the same regional host as the REST API, under /mcp/v1:

Region	MCP URL
Australia	`https://api.au.aplas.com/mcp/v1`
Europe	`https://api.eu.aplas.com/mcp/v1`
United States	`https://api.us.aplas.com/mcp/v1`

Use the URL that matches your organization's region. To find yours, open the Config dashboard in Aplas — the Data residency card shows your region and API endpoint. The examples below use the Australia URL; substitute your own.

Claude Code

Run the following command in your terminal:

claude mcp add --transport http aplas https://api.au.aplas.com/mcp/v1 --header "Authorization: Bearer YOUR_API_KEY"

Cursor

Open Settings > MCP.
Click Add new MCP server.
Add the following configuration:

{
  "mcpServers": {
    "aplas": {
      "url": "https://api.au.aplas.com/mcp/v1",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

VS Code (GitHub Copilot)

Create or update the .vscode/mcp.json file in your project:

{
  "servers": {
    "aplas": {
      "type": "http",
      "url": "https://api.au.aplas.com/mcp/v1",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Verifying the connection

Once configured, test the connection by asking your AI assistant a simple question:

List all indexes

If the connection is working, you should see a list of your Aplas indexes returned in the response.

Troubleshooting

Common issues

401 Unauthorized — Your API key is invalid or missing. Verify the key in Config → API and check that the Authorization: Bearer <key> header is set correctly.
Wrong region — API keys are scoped to a single region. If you're hitting the right URL but still getting auth errors, confirm the key was issued in the same region as the URL.
Connection timeout — Ensure your network allows outbound HTTPS connections to your regional api.<region>.aplas.com host.
No tools available — Restart your AI assistant client after adding the MCP server configuration.