Overview
Endpoint:https://us.datafold.com/mcp
Use the host you log in to: us.datafold.com, eub.datafold.com, or your dedicated or customer-hosted domain. The examples on this page use us.datafold.com.
Connect with OAuth
Add the server URL to your client, then follow its sign-in prompts.- Claude Code:
claude mcp add --transport http datafold https://us.datafold.com/mcp - Claude (claude.ai or Claude Desktop): add a custom connector with the URL
https://us.datafold.com/mcp.
OAuth sign-in needs your Datafold host to be served over HTTPS. It is not available when Datafold runs in Databricks Apps. Where OAuth is not available, use an API key.
Connect with an API key
Use an API key for MCP clients that do not support OAuth.Prerequisites
1
Navigate to Settings
Open the Datafold app and go to Settings > Account > API keys
2
Create API Key
Click Create API Key and store it securely
If you lose your API key, you’ll need to generate a new one. See the Introduction guide for more details.
Authentication
Send your API key as a Bearer token tohttps://us.datafold.com/mcp/ (with the trailing slash):
Key YOUR_API_KEY format used by the REST API is also accepted.
Include this header in your MCP client configuration.
Setup by Client
Claude Code
Claude Code
Run the following command in your terminal:Options:
--scope user- Makes the server available across all projects--header- Adds authentication header
Cursor
Cursor
Cursor supports MCP servers through project-specific or global configuration.Project-Specific Setup:Create Restart Cursor to load the configuration.
.cursor/mcp.json in your project directory:VS Code with Cline
VS Code with Cline
Cline is a VS Code extension that supports MCP servers.Steps:
- Install the Cline extension
- Click the MCP Servers icon in Cline’s navigation
- Select Configure tab → Advanced MCP Settings
- Add to
cline_mcp_settings.json:
- Toggle the switch to enable the server
- Close and reopen VS Code
Windsurf
Windsurf
Windsurf supports environment variable interpolation for secure credential storage.Configuration File: Using Environment Variables (Recommended):Set
~/.codeium/windsurf/mcp_config.jsonBasic Configuration:DATAFOLD_API_KEY as an environment variable, then restart Windsurf.Continue.dev
Continue.dev
Continue.dev supports MCP in agent mode through YAML configuration.Configuration Directory:
.continue/mcpServers/Create datafold.yaml:MCP can only be used in agent mode within Continue.dev.
Zed
Zed
Zed supports MCP through custom configuration in settings.Steps:
- Open Zed
- Go to Preferences > Settings (
⌘,on macOS) - Add a
context_serverssection:
- Check the Agent Panel - the indicator should be green when active
OpenCode
OpenCode
OpenCode supports both local and remote MCP servers.Configuration Files:CLI Setup:
You can also use the interactive CLI to add the server:Then follow the prompts to configure the Datafold remote MCP server.
- Global:
~/.config/opencode/opencode.json - Project:
opencode.jsonin project root (overrides global)
See the OpenCode MCP documentation for advanced configuration.
Gemini CLI
Gemini CLI
Gemini CLI supports remote MCP servers.Configuration Files:Manual Configuration:Edit your settings file:
- Global:
~/.gemini/settings.json - Project:
.gemini/settings.jsonin project directory
See the Gemini CLI MCP documentation for advanced features.
Kiro
Kiro
Kiro supports both global and project-specific MCP configuration.Global Configuration:Edit Project-Specific Configuration:Edit Changes apply automatically when you save the file.
~/.kiro/settings/mcp.json:.kiro/settings/mcp.json in your project directory with the same format.Using Environment Variables (Recommended):See the Kiro MCP documentation for advanced options.
Troubleshooting
Connection Errors
Connection Errors
Symptoms: “Unable to connect to MCP server” or “No valid session ID”Solutions:
- If you use an API key, verify it is valid
- Confirm the URL is your Datafold host followed by
/mcpfor OAuth sign-in (https://us.datafold.com/mcp) or/mcp/with an API key (https://us.datafold.com/mcp/) - Check header format:
Authorization: Bearer YOUR_API_KEY - Regenerate your API key if issues persist
Sign-in Errors
Sign-in Errors
Symptoms: The consent page refuses the request, or the client connects to the wrong organizationSolutions:
- Check that MCP is enabled for your organization and that your account is active
- Sign in with the account of the organization you want. On the consent page, click Use a different account to switch
- To start over, revoke the app under Settings > Account > Authorized OAuth apps, then sign in again from your client
Authentication Errors
Authentication Errors
Symptoms: “401 Unauthorized” or “403 Forbidden”Solutions:
- Generate a new API key if needed
- Verify the header is
Authorization: Bearer YOUR_API_KEY(Key YOUR_API_KEYalso works) - Check your API key hasn’t been revoked
Server Not Loading
Server Not Loading
Symptoms: MCP server doesn’t appear or shows as inactiveSolutions:
- Restart your MCP client completely
- Validate JSON/YAML syntax
- Check client logs for specific errors
- Ensure configuration file is in the correct location
Best Practices
Secure Your Keys
Never commit API keys to version control. Use environment variables or secure secret management.
Use Environment Variables
Reference API keys through environment variables rather than hardcoding them in configuration files.
Monitor Usage
Regularly check Datafold audit logs to monitor API usage and detect anomalies.
Rotate Keys
Periodically rotate your API keys as part of security best practices.
Additional Resources
API Introduction
Learn more about Datafold’s REST API
Model Context Protocol
Official MCP specification
Data Sources API
Explore data source endpoints
Data Diffs API
Learn about data diff operations
Support
If you need assistance:- Check the Datafold documentation
- Review your MCP client’s documentation
- Contact support via Slack, in-app chat, or support@datafold.com
