AI Assistant Setup

Prerequisites

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

Log in to Aplas and navigate to Settings > API Keys.
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.

Claude Code

Run the following command in your terminal:

claude mcp add --transport http aplas https://app.aplas.com/mcp/v1 --header "api_key: YOUR_API_KEY"

Cursor

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

{
  "mcpServers": {
    "aplas": {
      "url": "https://app.aplas.com/mcp/v1",
      "headers": {
        "api_key": "YOUR_API_KEY"
      }
    }
  }
}

VS Code (GitHub Copilot)

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

{
  "servers": {
    "aplas": {
      "type": "http",
      "url": "https://app.aplas.com/mcp/v1",
      "headers": {
        "api_key": "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 Settings > API Keys and check that the api_key header is set correctly.
Connection timeout — Ensure your network allows outbound HTTPS connections to app.aplas.com.
No tools available — Restart your AI assistant client after adding the MCP server configuration.