Client configuration

This page covers client-specific configuration formats, CLI flags, and advanced configuration examples for the DaVinci MCP Server.

Replace your-environment-id and your-client-id with your actual PingOne environment ID and OAuth Client ID in all examples below. DAVINCI_MCP_ENVIRONMENT_ID selects which PingOne/DaVinci environment the server queries, while AUTHORIZATION_CODE_CLIENT_ID identifies your worker application.

MCP client configuration

Claude Desktop
Claude Code (CLI)
VS Code (Cline)
Cursor
Gemini CLI

Add the following to your claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "davinci": {
      "command": "npx",
      "args": ["-y", "@ping-identity/davinci-mcp-server", "start"],
      "env": {
        "DAVINCI_MCP_ENVIRONMENT_ID": "your-environment-id",
        "AUTHORIZATION_CODE_CLIENT_ID": "your-client-id",
        "ROOT_DOMAIN": "pingone.com"
      }
    }
  }
}

Run the following command in your terminal:

claude mcp add --transport stdio davinci \
--env DAVINCI_MCP_ENVIRONMENT_ID="your-environment-id" \
--env AUTHORIZATION_CODE_CLIENT_ID="your-client-id" \
--env ROOT_DOMAIN="pingone.com" \
-- npx -y @ping-identity/davinci-mcp-server start

Open the Cline sidebar in VS Code.
Click the Settings icon.
Scroll to MCP Servers and click Add MCP Server.

Use the following configuration:

{
  "davinci": {
    "command": "npx",
    "args": ["-y", "@ping-identity/davinci-mcp-server", "start"],
    "env": {
      "DAVINCI_MCP_ENVIRONMENT_ID": "your-environment-id",
      "AUTHORIZATION_CODE_CLIENT_ID": "your-client-id",
      "ROOT_DOMAIN": "pingone.com"
    }
  }
}

Open Cursor Settings > Features > MCP.
Click + Add New MCP Server.
Set the following:
- Name: davinci
- Type: command.
- Command:
  npx -y @ping-identity/davinci-mcp-server start
Add environment variables:
- DAVINCI_MCP_ENVIRONMENT_ID: your-environment-id
- AUTHORIZATION_CODE_CLIENT_ID: your-client-id
- ROOT_DOMAIN: pingone.com

Use the target PingOne environment UUID for DAVINCI_MCP_ENVIRONMENT_ID (not the OAuth client ID).

Add the following to your ~/.gemini/settings.json:

{
  "mcpServers": {
    "davinci": {
      "command": "npx",
      "args": ["-y", "@ping-identity/davinci-mcp-server", "start"],
      "env": {
        "DAVINCI_MCP_ENVIRONMENT_ID": "your-environment-id",
        "AUTHORIZATION_CODE_CLIENT_ID": "your-client-id",
        "ROOT_DOMAIN": "pingone.com"
      }
    }
  }
}

CLI flags

The start command supports the following flags. Add them to the args array in your MCP client configuration.

Filter tools

Flag Description

Flag	Description
`--include-collections <list>`	Comma-separated list of collection names to include (for example, `davinci_admin`).
`--exclude-collections <list>`	Comma-separated list of collection names to exclude.
`--include-tools <list>`	Comma-separated list of tool names to include.
`--exclude-tools <list>`	Comma-separated list of tool names to exclude.

--include-collections <list>

Comma-separated list of collection names to include (for example, davinci_admin).

--exclude-collections <list>

Comma-separated list of collection names to exclude.

--include-tools <list>

Comma-separated list of tool names to include.

--exclude-tools <list>

Comma-separated list of tool names to exclude.

Other flags

Flag Description

Flag	Description
`--verbose`	Enable verbose logging to `stderr`.
`--logout`	Clear stored tokens from the system keychain on startup.
`--help`	Show the help message and exit.

--verbose

Enable verbose logging to stderr.

--logout

Clear stored tokens from the system keychain on startup.

--help

Show the help message and exit.

Advanced configuration examples

Filter by tool collection

Limit exposed tools to only those in the davinci_admin collection.

{
  "mcpServers": {
    "davinci": {
      "command": "npx",
      "args": [
        "-y",
        "@ping-identity/davinci-mcp-server",
        "start",
        "--include-collections",
        "davinci_admin"
      ],
      "env": {
        "DAVINCI_MCP_ENVIRONMENT_ID": "your-environment-id",
        "AUTHORIZATION_CODE_CLIENT_ID": "your-client-id",
        "ROOT_DOMAIN": "pingone.com"
      }
    }
  }
}

Filter by specific tools

Expose only a targeted set of tools, such as only flow tools.

{
  "mcpServers": {
    "davinci": {
      "command": "npx",
      "args": [
        "-y",
        "@ping-identity/davinci-mcp-server",
        "start",
        "--include-tools",
        "list_flows,describe_flow"
      ],
      "env": {
        "DAVINCI_MCP_ENVIRONMENT_ID": "your-environment-id",
        "AUTHORIZATION_CODE_CLIENT_ID": "your-client-id",
        "ROOT_DOMAIN": "pingone.com"
      }
    }
  }
}

Exclude specific tools

Enable all tools except variable-related ones.

{
  "mcpServers": {
    "davinci": {
      "command": "npx",
      "args": [
        "-y",
        "@ping-identity/davinci-mcp-server",
        "start",
        "--exclude-tools",
        "describe_variable,list_variables"
      ],
      "env": {
        "DAVINCI_MCP_ENVIRONMENT_ID": "your-environment-id",
        "AUTHORIZATION_CODE_CLIENT_ID": "your-client-id",
        "ROOT_DOMAIN": "pingone.com"
      }
    }
  }
}

Enable verbose logging

Enable detailed logging to help debug connection or tool issues.

{
  "mcpServers": {
    "davinci": {
      "command": "npx",
      "args": ["-y", "@ping-identity/davinci-mcp-server", "start", "--verbose"],
      "env": {
        "DAVINCI_MCP_ENVIRONMENT_ID": "your-environment-id",
        "AUTHORIZATION_CODE_CLIENT_ID": "your-client-id",
        "ROOT_DOMAIN": "pingone.com"
      }
    }
  }
}

Maintenance commands

Run these commands manually in your terminal when needed.

Clear stored credentials:

npx -y @ping-identity/davinci-mcp-server start --logout

Display help:

npx -y @ping-identity/davinci-mcp-server --help

Build with AI