Verification

Quick Configuration Reference¶

For a quick reference, here are the configuration formats for each supported IDE:

Cursor¶

{
  "mcpServers": {
    "akashic-mcp": {
      "type": "http",
      "url": "https://akashic-mcp.com/mcp"
    }
  }
}

File: %APPDATA%\Cursor\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json (Windows)

VS Code¶

{
  "servers": {
    "akashic-mcp": {
      "type": "http",
      "url": "https://akashic-mcp.com/mcp"
    }
  }
}

File: .vscode/mcp.json (project-level) or user settings

Windsurf¶

{
  "mcpServers": {
    "akashic-mcp": {
      "serverUrl": "https://akashic-mcp.com/mcp"
    }
  }
}

File: %APPDATA%\Windsurf\mcp.json (Windows)

Visual Studio¶

{
  "servers": {
    "akashic-mcp": {
      "type": "http",
      "url": "https://akashic-mcp.com/mcp"
    }
  }
}

File: .vs/mcp.json (solution root)

JetBrains IDEs¶

{
  "mcpServers": {
    "akashic-mcp": {
      "url": "https://akashic-mcp.com/mcp"
    }
  }
}

File: %APPDATA%\JetBrains\<IDE>\mcp.json (Windows)

Kilo Code¶

{
  "akashic-mcp": {
    "type": "streamable-http",
    "url": "https://akashic-mcp.com/mcp",
    "disabled": false
  }
}

File: %APPDATA%\KiloCode\mcp.json (Windows)

Authentication

Configure your MCP token in the client (e.g. Authorization: Bearer mcp_xxxxx). Create or copy the token from https://akashic-mcp.com/admin → Settings.

Authentication¶

Akashic MCP uses OAuth 2.0 for secure authentication. The authentication flow is automatic:

First Tool Use: When you first use an Akashic MCP tool, you'll be prompted to authenticate
OAuth Redirect: Your client will redirect you to the authentication URL
Login: Complete the login using Firebase/Google OAuth
Return: After authentication, return to your client
Ready: Tools will now work automatically

For detailed authentication information, see the Authentication Guide.

Verifying Your Connection¶

After configuration, verify that your connection works:

Test the Endpoint¶

Test the MCP endpoint directly:

curl -X POST https://akashic-mcp.com/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/list",
    "params": {},
    "id": 1
  }'

Expected response:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "tools": [
      {
        "name": "list_collections",
        "description": "..."
      },
      ...
    ]
  }
}

In Your Client¶

List Tools: Your client should show Akashic MCP tools available
Test Tool: Try using a simple tool like list_collections from your AI assistant
Check Logs: Review client logs for any connection errors

Troubleshooting¶

Common Issues¶

Connection Timeout¶

Check network: Ensure you have internet connectivity
Verify URL: Confirm the endpoint URL is correct
Firewall: Check if a firewall is blocking the connection
Proxy: If behind a proxy, configure your client accordingly

Authentication Errors¶

Follow OAuth flow: Complete the authentication when prompted
Check tokens: Ensure tokens haven't expired
Re-authenticate: Try disconnecting and reconnecting

Tools Not Appearing¶

Restart client: Fully restart your IDE or LLM client
Check configuration: Verify JSON syntax is correct
Verify endpoint: Test the endpoint manually with curl
Check logs: Review client logs for error messages

JSON Syntax Errors¶

Validate JSON: Use a JSON validator to check syntax
No trailing commas: Ensure no trailing commas in JSON
Proper quotes: Use double quotes for JSON strings

Getting Help¶

If you continue to experience issues:

Discord Community: Join our Discord server for support and community help
Check the API Reference for endpoint details
Review the Authentication Guide for auth issues
Verify your configuration matches the examples above
Test the endpoint directly with curl to isolate client issues

Supported IDEs Summary¶

IDE	Configuration Format	File Location
Cursor	`mcpServers` with `type: "http"`	`%APPDATA%\Cursor\User\globalStorage\...\cline_mcp_settings.json`
VS Code	`servers` with `type: "http"`	`.vscode/mcp.json` or user settings
TRAE	`servers` with `type: "http"`	`.vscode/mcp.json` or user settings
Windsurf	`mcpServers` with `serverUrl`	`%APPDATA%\Windsurf\mcp.json`
Visual Studio	`servers` with `type: "http"`	`.vs/mcp.json`
JetBrains	`mcpServers` with `url`	`%APPDATA%\JetBrains\<IDE>\mcp.json`
Kilo Code	Root object with `type: "streamable-http"`	`%APPDATA%\KiloCode\mcp.json`