Connect to DDAI with MCP

Connect Claude Code, Codex, or another MCP-compatible application to your DDAI business data using our secure, read-only MCP server.

MCP Server URL

https://mcp.datadiscourse.ai/mcp

DDAI uses OAuth 2.0. When you connect, your browser will open so you can sign in to DDAI and approve read-only access. You do not need to create or paste an access token.

Claude Code

Run this command in your terminal:

claude mcp add --transport http ddai https://mcp.datadiscourse.ai/mcp

Then:

  1. Open Claude Code.

  2. Enter /mcp.

  3. Select ddai and authenticate.

  4. Sign in to DDAI in the browser window.

  5. Approve read-only access.

Try asking:

Use DDAI to show me what business data is available.

OpenAI Codex

Run these commands in your terminal:

codex mcp add ddai --url https://mcp.datadiscourse.ai/mcp

codex mcp login ddai

Your browser will open so you can sign in to DDAI and approve access.

To confirm the connection:

codex mcp get ddai

Then try:

Use DDAI to list my available business metrics and explain the most important ones.

Other MCP-Compatible Apps

In your application’s MCP settings:

  1. Choose Add remote MCP server or Streamable HTTP.

  2. Enter a name such as DDAI.

  3. Enter the server URL:

    https://mcp.datadiscourse.ai/mcp

  4. Select OAuth 2.0 if asked for an authentication method.

  5. Complete the DDAI login and consent process in your browser.

No client ID or client secret is required. DDAI supports OAuth Dynamic Client Registration.

Applications Without OAuth Support

If your MCP application cannot authenticate using OAuth:

  1. Sign in to DDAI.

  2. Open Settings → Access.

  3. Create a personal access token.

  4. Configure your MCP application to send:

    Authorization: Bearer YOUR_TOKEN

Keep personal access tokens private. Do not include them in prompts, source code, or public configuration files.

What You Can Do

After connecting, you can ask your AI assistant to:

  • Explore available business tables and metrics.

  • Answer questions using read-only SQL.

  • Analyze revenue, customers, churn, and other business data.

  • Explain how metrics are defined.

  • Create summaries and reports from synchronized data.

Example:

Calculate monthly recurring revenue for the last six months and summarize the trend.

All DDAI MCP tools are read-only and restricted to your organization’s data.