ClickHouse · OAuth Scopes

ClickHouse OAuth Scopes

OAuth 2.0 probed

ClickHouse publishes 5 OAuth 2.0 scopes. Scopes are the fine-grained permissions an application requests at authorization time to act against the ClickHouse API on a user’s behalf.

This index is generated from the provider’s OpenAPI security definitions (and, where available, its documented scope reference) and refreshes on every APIs.io network build. Browse every provider’s scopes at scopes.apis.io.

ClickHouseAnalyticsCloud DatabaseColumn-OrientedDatabaseOLAPOpen SourceReal-TimeSQL

Scopes: 5 Flows: Method: probed

Scopes (5)

Scope	Description	Flows
mcp:access	Access the ClickHouse Cloud remote MCP server and its read-only tools
clickstack:access	Access ClickStack observability resources through the MCP server
openid	Standard OpenID Connect scope — issue an ID token for the authenticated ClickHouse Cloud user
profile	Standard OIDC scope — basic profile claims
email	Standard OIDC scope — email claim

📄 Provider scope reference:

Source

OAuth Scopes

specification: OAuth Scopes
specificationVersion: '0.1'
provider: ClickHouse
providerId: clickhouse
generated: '2026-09-05'
method: probed
source: >-
  https://mcp.clickhouse.cloud/.well-known/oauth-authorization-server and
  https://mcp.clickhouse.cloud/.well-known/oauth-protected-resource (+ the per-resource variant
  /.well-known/oauth-protected-resource/mcp), all fetched anonymously on 2026-09-05 with HTTP 200
note: >-
  The ClickHouse Cloud REST API at api.clickhouse.cloud does NOT use OAuth — it declares a single
  securityScheme, HTTP Basic with an API key ID and secret, and therefore has no scopes. The only OAuth
  surface ClickHouse publishes is the remote MCP server, and the scopes below are read straight from its
  RFC 8414 / RFC 9728 discovery documents. Permissions on the REST API are expressed as key ROLES
  (developer / admin) rather than scopes; those are recorded here too because they are the closest
  equivalent a caller has to reason about.
oauth:
  applies_to: https://mcp.clickhouse.cloud/mcp
  issuer: https://mcp.clickhouse.cloud
  authorization_endpoint: https://mcp.clickhouse.cloud/authorize
  token_endpoint: https://mcp.clickhouse.cloud/token
  registration_endpoint: https://mcp.clickhouse.cloud/register
  grant_types_supported:
    - authorization_code
    - refresh_token
  response_types_supported:
    - code
  code_challenge_methods_supported:
    - S256
  token_endpoint_auth_methods_supported:
    - none
  docs: https://clickhouse.com/docs/cloud/features/ai-ml/remote-mcp
scope_count: 5
scopes:
  - name: 'mcp:access'
    description: Access the ClickHouse Cloud remote MCP server and its read-only tools
    resource: https://mcp.clickhouse.cloud/mcp
  - name: 'clickstack:access'
    description: Access ClickStack observability resources through the MCP server
    resource: https://mcp.clickhouse.cloud
  - name: openid
    description: Standard OpenID Connect scope — issue an ID token for the authenticated ClickHouse Cloud user
  - name: profile
    description: Standard OIDC scope — basic profile claims
  - name: email
    description: Standard OIDC scope — email claim
rest_api_permissions:
  model: role-per-key (not scopes)
  scheme: basicAuth (HTTP Basic — key ID as username, key secret as password)
  roles:
    - name: developer
      grants: read-only permissions for assigned services
    - name: admin
      grants: full read and write permissions
  additional_controls:
    - Per-key expiration
    - Per-key IP allowlist (single IP or CIDR)
    - Query API Endpoints require Organization Role `Member` (minimum) plus Service Role access to `Query Endpoints`
  docs: https://clickhouse.com/docs/cloud/manage/openapi

Work with this as data

Every scope set here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for oauth scopes

4 MCP tools reach this

find_scopesBrowse and filter every scope set in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This scope set

curl "https://apis.io/api/v1/scopes/clickhouse-scopes"

All oauth scopes

curl "https://apis.io/api/v1/scopes?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.