Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -63,7 +63,7 @@ You can also use a [Service Principal ](https://learn.microsoft.com/en-us/entra/

Step 1 : Create an App Registration in Entra with the following **Application** permissions on the **Microsoft Graph API**

Use the following URL as redirect URI : [https://dust.tt/oauth/microsoft/finalize](https://dust.tt/oauth/microsoft/finalize) or [https://eu.dust.tt/oauth/microsoft/finalize](https://eu.dust.tt/oauth/microsoft/finalize)
Use the following URL as redirect URI : [https://app.dust.tt/oauth/microsoft/finalize](https://app.dust.tt/oauth/microsoft/finalize) or [https://app.dust.tt/oauth/microsoft/finalize](https://app.dust.tt/oauth/microsoft/finalize)

| **API name** | **Claim value** | **Permission** | **Type** | **Granted through** | **Granted by** | Comment |
| --- | --- | --- | --- | --- | --- | :-- |
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -64,7 +64,7 @@ The manifest contains a region-specific OAuth redirect URL. Use the **US** manif
},
"oauth_config": {
"redirect_urls": [
"https://dust.tt/oauth/slack/finalize"
"https://app.dust.tt/oauth/slack/finalize"
],
"scopes": {
"user": [
Expand Down Expand Up @@ -141,7 +141,7 @@ The manifest contains a region-specific OAuth redirect URL. Use the **US** manif
},
"oauth_config": {
"redirect_urls": [
"https://eu.dust.tt/oauth/slack/finalize"
"https://app.dust.tt/oauth/slack/finalize"
],
"scopes": {
"user": [
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -56,7 +56,7 @@ Which translates to the following setup process.

1. In Github : create an OAuth app from the [developer settings](https://github.com/settings/developers) page
1. write down the client ID and client Secret
2. use [https://dust.tt/oauth/mcp_static/finalize](https://dust.tt/oauth/mcp_static/finalize) or https://eu.dust.tt/oauth/mcp_static/finalize as the redirect URI depending on your Dust region.
2. use [https://app.dust.tt/oauth/mcp_static/finalize](https://app.dust.tt/oauth/mcp_static/finalize) or https://app.dust.tt/oauth/mcp_static/finalize as the redirect URI depending on your Dust region.
2. In Dust : Navigate to Spaces > Tools > Add tools > Add MCP server and use the following settings
1. Static Oauth URL : [https://api.githubcopilot.com/mcp](https://api.githubcopilot.com/mcp)
2. OAuth token endpoint : [https://github.com/login/oauth/access_token](https://github.com/login/oauth/access_token)
Expand Down Expand Up @@ -87,14 +87,14 @@ If you operate a third-party MCP server and want to support Dust users connectin

| URL | Region |
| ---------------------------------------- | ------ |
| `https://dust.tt/oauth/mcp/finalize` | Global |
| `https://app.dust.tt/oauth/mcp/finalize` | Global |
| `https://app.dust.tt/oauth/mcp/finalize` | Global |
| `https://eu.dust.tt/oauth/mcp/finalize` | EU |
| `https://app.dust.tt/oauth/mcp/finalize` | EU |

**Static OAuth:**

| URL | Region |
| ----------------------------------------------- | ------ |
| `https://dust.tt/oauth/mcp_static/finalize` | Global |
| `https://app.dust.tt/oauth/mcp_static/finalize` | Global |
| `https://app.dust.tt/oauth/mcp_static/finalize` | Global |
| `https://eu.dust.tt/oauth/mcp_static/finalize` | EU |
| `https://app.dust.tt/oauth/mcp_static/finalize` | EU |
Original file line number Diff line number Diff line change
Expand Up @@ -24,8 +24,6 @@ Go to Salesforce Setup (gear icon in the top right corner). In the search bar on
**Set the callback URLs**

```
https://dust.tt/oauth/salesforce/finalize
https://eu.dust.tt/oauth/salesforce/finalize
https://app.dust.tt/oauth/salesforce/finalize
```

Expand Down
4 changes: 2 additions & 2 deletions docs/user-documentation/agents/tools/airtable.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -68,8 +68,8 @@ Under **"About your integration"**, fill in:
Under **"OAuth redirect URLs"**, add these three URIs:

```
https://dust.tt/oauth/mcp_static/finalize
https://eu.dust.tt/oauth/mcp_static/finalize
https://app.dust.tt/oauth/mcp_static/finalize
https://app.dust.tt/oauth/mcp_static/finalize
https://app.dust.tt/oauth/mcp_static/finalize
```

Expand Down
2 changes: 1 addition & 1 deletion docs/user-documentation/agents/tools/asana.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ Asana tools let your agents work with Asana directly from Dust once an administr
- **Personal credentials**: Each user authorizes Asana with their own account when they first use an agent with the tool
4. Click **Connect** and complete the Asana OAuth flow
1. Use your created Asana app credentials
2. The redirect URL field should be https://dust.tt/oauth/mcp_static/finalize (or https://eu.dust.tt/oauth/mcp_static/finalize for EU workspaces)
2. The redirect URL field should be https://app.dust.tt/oauth/mcp_static/finalize (or https://app.dust.tt/oauth/mcp_static/finalize for EU workspaces)

### Important: Finalize in Asana (Manage Distribution)

Expand Down
8 changes: 4 additions & 4 deletions docs/user-documentation/agents/tools/databricks.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -60,9 +60,9 @@ You need Databricks **account admin** rights for this step.
- **Redirect URLs**: add the Dust Static OAuth callbacks (one per line):

```
https://dust.tt/oauth/mcp_static/finalize
https://app.dust.tt/oauth/mcp_static/finalize
https://eu.dust.tt/oauth/mcp_static/finalize
https://app.dust.tt/oauth/mcp_static/finalize
https://app.dust.tt/oauth/mcp_static/finalize
```

- **Access scopes**: check **All APIs**, or the fine-grained scope matching the endpoint you want to connect (for example **SQL** for the `/api/2.0/mcp/sql` server)
Expand Down Expand Up @@ -143,8 +143,8 @@ Use this option if the managed MCP servers are not available on your Databricks
- **Connection Name**: "Dust Integration"
- **Redirect URLs**: Add both callback URLs:
```
https://dust.tt/oauth/databricks/finalize
https://eu.dust.tt/oauth/databricks/finalize
https://app.dust.tt/oauth/databricks/finalize
https://app.dust.tt/oauth/databricks/finalize
```

4. **Configure Access Scopes**
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@ Create a new client:
- Application type: "Web application".
- External Client App Name: "Dust Gsheets Integration".
- Authorized javascript origins: [https://dust.tt](https://dust.tt) and [https://eu.dust.tt](https://eu.dust.tt)
- Authorized redirect URIs: [https://dust.tt/oauth/gmail/finalize](https://dust.tt/oauth/gmail/finalize) and [https://eu.dust.tt/oauth/gmail/finalize](https://eu.dust.tt/oauth/gmail/finalize)
- Authorized redirect URIs: [https://app.dust.tt/oauth/gmail/finalize](https://app.dust.tt/oauth/gmail/finalize) and [https://app.dust.tt/oauth/gmail/finalize](https://app.dust.tt/oauth/gmail/finalize)

## Admin: Setup in Dust

Expand Down
4 changes: 2 additions & 2 deletions docs/user-documentation/agents/tools/netsuite.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -76,8 +76,8 @@ Under **Authentication**, check:

```
https://app.dust.tt/oauth/mcp_static/finalize
https://eu.dust.tt/oauth/mcp_static/finalize
https://dust.tt/oauth/mcp_static/finalize
https://app.dust.tt/oauth/mcp_static/finalize
https://app.dust.tt/oauth/mcp_static/finalize
```

* **Dynamic Client Registration**
Expand Down
4 changes: 2 additions & 2 deletions docs/user-documentation/agents/tools/power-bi.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -32,8 +32,8 @@ Add these three redirect URIs:

```
https://app.dust.tt/oauth/mcp_static/finalize
https://eu.dust.tt/oauth/mcp_static/finalize
https://dust.tt/oauth/mcp_static/finalize
https://app.dust.tt/oauth/mcp_static/finalize
https://app.dust.tt/oauth/mcp_static/finalize
```

Under **settings**, set **Allow public client flows** to **Enabled**. Click **Save**.
Expand Down
4 changes: 2 additions & 2 deletions docs/user-documentation/agents/tools/snowflake.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -28,14 +28,14 @@ CREATE SECURITY INTEGRATION dust_oauth
ENABLED = TRUE
OAUTH_CLIENT = CUSTOM
OAUTH_CLIENT_TYPE = 'CONFIDENTIAL'
OAUTH_REDIRECT_URI = 'https://dust.tt/oauth/snowflake/finalize'
OAUTH_REDIRECT_URI = 'https://app.dust.tt/oauth/snowflake/finalize'
OAUTH_ISSUE_REFRESH_TOKENS = TRUE
OAUTH_REFRESH_TOKEN_VALIDITY = 7776000;
```

<Info>
If your workspace is on the EU region, use
`https://eu.dust.tt/oauth/snowflake/finalize` as the redirect URI instead.
`https://app.dust.tt/oauth/snowflake/finalize` as the redirect URI instead.
</Info>

### 2. Get the Client ID and Client Secret
Expand Down
4 changes: 1 addition & 3 deletions docs/user-documentation/agents/tools/ukg-ready.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -12,9 +12,7 @@ This integration requires read access to your UKG Ready account facilitated via
1. Login to UKG Ready and navigate to the "Settings" page > then "Global Setup" and then click "Company Setup":
2. Find the OAuth Applications widget. Create a new one.
3. Choose the "Interactive" Application type. You will see that the OAuth client ID was autogenerated.
4. You will be prompted to add a redirect URL:
1. For US Dust environments, this url should be https://app.dust.tt/oauth/ukg_ready/finalize
2. For EU Dust environments, this url should be https://app.dust.tt/oauth/ukg_ready/finalize
4. You will be prompted to add a redirect URL: this url should be [https://app.dust.tt/oauth/ukg_ready/finalize](https://app.dust.tt/oauth/ukg_ready/finalize)

### Setup in Dust

Expand Down