Documentation Index

Fetch the complete documentation index at: https://support.govdash.com/llms.txt

Use this file to discover all available pages before exploring further.

Dash Connectors Setup Guide

Prev Next

Dash Connectors let Dash use tools from the external services your team already works in (such as Slack, Google Drive, GitHub, Linear, HubSpot, and Microsoft services) right alongside your GovDash data. This guide covers how team admins make connectors available to their team.

How To Guide

If you’re an end user looking to connect your accounts and use connectors in Dash, see our Using Dash Connectors article.

Important: Connectors and CUI

  • When Dash uses a connector, requests leave the GovDash authorization boundary and go to the external provider.

  • Connectors never work with CUI. Dash will not send CUI to a connector, and connectors are not available in CUI contexts.

  • Only enable connectors for providers your organization has approved for non-CUI business data.


Overview

There are two types of Dash Connectors:

  • Native connectors are built-in providers such as Slack, Google Drive, GitHub, Linear, HubSpot, and Microsoft services. An admin enables a provider for the team, then each user connects their own account through that provider’s sign-in flow.

  • Custom connectors are MCP (Model Context Protocol) endpoints your team manages, configured with a URL and headers. They are team-owned, users do not sign in individually.

Responsibilities split cleanly between admins and users: admins control which connectors are available to the team, and each user controls which available connectors are active in their own Dash conversations.

Permissions

  • Enabling native connectors and managing custom connectors requires the Manage Team Integrations permission.

  • Regular users can connect their own accounts for enabled native connectors and choose which available connectors are active in their Dash conversations.

  • Regular users cannot create, edit, delete, or disconnect team-owned custom connectors.

Enable a native connector

  1. Login to GovDash (dashboard.govdash.us).

  2. Go to Settings > Configurations > Integrations and scroll to Dash Connectors.

  3. Under Native Connectors, find the provider you want to make available.

  4. Click Enable.

The provider is now available to everyone on your team. Users will see it listed in their Connectors menu in Dash, where they can connect their own account.

A few things to know:

  • Enabling a native connector does not connect any user accounts. Each user still completes the provider’s sign-in flow before Dash can act on their behalf, using their own permissions in that tool.

  • You can disable a provider at any time from the same page. Disabling affects the whole team, the provider is removed from every user’s available connectors.

  • Providers marked Coming soon cannot be enabled yet.

  • Microsoft connectors (such as Outlook, Microsoft Calendar, Microsoft Teams, Word, and SharePoint) require your team’s Microsoft tenant to be linked. See our Microsoft integration documentation for tenant setup.

Set up a custom connector

Custom connectors let you point Dash at any MCP server your team runs or subscribes to — for example, an internal tool or a vendor that exposes an MCP endpoint.

  1. Go to Settings > Configurations > Integrations and scroll to Dash Connectors.

  2. Under Custom Connectors, click Add new.

  3. Enter a name for the connector. This is what your team will see in their Connectors menu.

  4. Enter the Config JSON with the server URL and any headers. Headers typically carry secrets such as an API token or bearer authorization. For example:

{
"url": "https://mcp.example.com/mcp",
 "headers": {
   "Authorization": "Bearer token-value"
 }
}

  1. Click Save.

When you save, GovDash validates the connector by opening the MCP server and listing its tools. If validation succeeds, you’ll see a success message with the number of tools found, and the connector appears in your Custom Connectors list. If validation fails, the connector is not saved — see Troubleshooting below.

A few things to know:

  • The URL must use https://

  • Custom connectors are team-owned and available to all team members. Users don’t sign in individually, they simply toggle the connector on in their Connectors menu.

  • Treat the Config JSON headers like any other credential: use tokens scoped to the minimum access Dash needs.

  • Custom OAuth connectors are on the roadmap; today, custom connectors authenticate via headers only.

What happens when you change connector configuration

  • Disabling a native provider affects the whole team. The provider is removed from the team’s available connectors, and users can no longer use it in Dash.

  • Deleting a custom connector affects the whole team. GovDash removes it from all users’ saved connector selections and from existing conversations.

Troubleshooting

  • Users can’t connect a native provider — confirm an admin has enabled that provider for the team under Settings > Configurations > Integrations.

  • A user’s sign-in to a provider fails — have the user close the popup and try connecting again from the Connectors menu. If it keeps failing, contact GovDash support.

  • A custom connector fails to save — confirm the URL uses https://, the headers (including any token) are complete and current, and the MCP server is reachable and can list its tools.

  • A user sees “Reconnect required” — the user’s session with that provider expired. They can reconnect from the Connectors menu.

  • An existing conversation stopped using a connector — confirm the connector wasn’t disabled, deleted, or otherwise made unavailable by an admin change.