## Set up the Databricks connector

Configure the Databricks connector in [AI Studio](https://app.writer.com/aistudio) under **Connectors & Tools**. The Databricks connector uses OAuth to authenticate with Databricks-managed MCP servers.

The Databricks connector only supports organization-managed OAuth. WRITER-managed OAuth is not available for Databricks.

### Obtain your Databricks MCP server URL

Before configuring the connector in AI Studio, locate your MCP server endpoint in your Databricks workspace:

1. Log in to your [Databricks workspace](https://accounts.cloud.databricks.com/)
2. Navigate to **AI/ML → Agents → MCP Servers**
3. Select the managed MCP server you want to connect (for example, SQL or Genie)
4. Copy the MCP server endpoint URL for use in [AI Studio](https://dev.writer.com/connectors/databricks#configure-the-connector-in-ai-studio) The URL format depends on the type of MCP server:

| Server type                      | Example URL format                                               |
|----------------------------------|-----------------------------------------------------------------|
| Vector search                    | `https://<workspace-hostname>/api/2.0/mcp/vector-search/{catalog}/{schema}` |
| DBSQL                            | `https://<workspace-hostname>/api/2.0/mcp/sql`                 |
| Genie space                      | `https://<workspace-hostname>/api/2.0/mcp/genie/{genie_space_id}` |
| Unity Catalog functions          | `https://<workspace-hostname>/api/2.0/mcp/functions/{catalog}/{schema}` |

For more details about Databricks managed MCP servers and how to get the IDs for specific server types, see [Databricks MCP documentation](https://docs.databricks.com/aws/en/generative-ai/mcp/managed-mcp).

### Create a Databricks OAuth application

Create an OAuth 2.0 application in Databricks:

1. Navigate to the [Databricks Account Console](https://accounts.cloud.databricks.com/)
2. Select **Settings** in the left navigation
3. Select **App connections**
4. Select **Add connection**
5. Enter an application name (for example, “Writer MCP connector”)
6. Add the Writer redirect URI:
    
    ```
    https://app.writer.com/mcp/oauth/callback
    ```
   
   If your organization is deployed in the EU, use `https://app.eu2.writer.com/mcp/oauth/callback` instead.
7. Select **All APIs** under Access Scopes
8. Ensure **Generate a client secret** is selected
9. Set the access token TTL (for example, 10 minutes) and refresh token TTL (for example, 129600 minutes or 90 days)
10. Select **Create**
11. Copy the client ID and client secret for use in [AI Studio](https://dev.writer.com/connectors/databricks#configure-the-connector-in-ai-studio)

For detailed instructions, see [Databricks OAuth documentation](https://docs.databricks.com/aws/en/generative-ai/mcp/connect-external-services#create-the-databricks-oauth-application).

### Configure the connector in AI Studio

After creating your Databricks OAuth application:

1. Navigate to **Connectors & Tools** in [AI Studio](https://app.writer.com/aistudio)
2. Select the Databricks connector
3. Select who has access by default (all users or specific teams)
4. Enter your Databricks MCP server endpoint URL as the **URL**
5. Enter your OAuth client ID and client secret

## Next steps

- [Set up connectors](https://support.writer.com/article/299-setting-up-connectors): Learn how to configure and enable connectors in AI Studio
- [Tool calling guide](https://dev.writer.com/home/tool-calling): Understand how AI agents use tools in conversations
- [WRITER Agent guide](https://support.writer.com/article/293-how-to-use-action-agent): Learn how to use WRITER Agent with connected tools
- [MCP gateway overview](https://dev.writer.com/home/mcp-gateway): Learn about Writer’s MCP gateway architecture