Support API key authentication for per-project MCP configuration

[sabrehagen]

Problem

When using the PostHog MCP server with multiple PostHog organizations (e.g., separate orgs for different projects), there's no way to configure per-project authentication. The MCP server currently only supports OAuth, and OAuth credentials are stored globally keyed by server URL. This means all projects sharing the same PostHog Cloud instance (e.g., mcp.posthog.com) share a single OAuth session.

Switching between orgs requires manually clearing OAuth credentials and re-authenticating through the browser flow each time you change projects, which is disruptive.

Proposed solution

Support an environment variable for API key authentication, e.g. POSTHOG_API_KEY, as an alternative to OAuth. This would allow users to:

1. Set different API keys per project (via .env, project-level MCP config, or IDE settings)
2. Avoid repeated OAuth re-authentication when switching between projects tied to different orgs
3. Use the MCP server in non-interactive / CI environments

Example configuration

{
  "mcpServers": {
    "posthog": {
      "type": "http",
      "url": "${POSTHOG_MCP_URL:-https://mcp.posthog.com/mcp}",
      "headers": {
        "Authorization": "Bearer ${POSTHOG_API_KEY}"
      }
    }
  }
}

Or handled server-side, where the MCP server accepts an API key and skips OAuth when one is provided.

Current workaround

The only workaround is to clear the OAuth token in ~/.config/claude/.credentials.json and re-authenticate each time you switch projects — not practical for frequent context switching.

Environment

• Claude Code with PostHog plugin v1.0.0
• Multiple PostHog organizations on the same cloud instance (US)

[rafaeelaudibert]

Or handled server-side, where the MCP server accepts an API key and skips OAuth when one is provided.

This is done already! If you provide a personal API Key to the Authorization header we're supposed to skip OAuth authentication. Does this mean fixing this is only a matter of exposing the environment variable to the plugin? I believe we can easily work on that if you confirm that would fix your problem

[sabrehagen]

I will test and let you know. Thanks!