Skip to main content

Sally MCP with Langdock

Langdock is an enterprise AI platform that supports MCP servers as integrations. The Model Context Protocol (MCP) is an open standard that lets AI tools connect to external data sources. By adding the Sally MCP endpoint in Langdock, all team members with access can query Sally meeting data from their assistants, for example to search past meetings, review summaries, or pull transcripts for follow-ups. MCP tools are automatically converted into Langdock actions, so there's no extra development work required.

For background on the Sally MCP Connector, available tools, and security best practices, see the General Setup Guide.

Prerequisites
  • A Langdock account with permission to add integrations (admin or integration-manager role).
  • An active Sally user with access to at least one company account.
  • Sally MCP enabled for your company account (admin setting).
One token per team or per user?

Langdock integrations are typically team-wide. If you use a single Sally PAT, all Langdock users will see the meeting data that specific Sally user has access to. For correct per-user scoping, each user should create their own PAT and add their own integration instance.


Quick Navigation

  1. Create a Personal Access Token in Sally
  2. Set up the MCP connection in Langdock
  3. Troubleshooting

1. Create a Personal Access Token in Sally

A Personal Access Token (PAT) is the credential Langdock uses to authenticate against the Sally MCP endpoint. You create it once.

  1. Log in to Sally at app.sally.io.
  2. Open Settings in the bottom-left of the sidebar.
Sally sidebar with the Settings entry highlighted in the bottom-left
Open Settings
  1. In Settings, choose "Integrations". Under "Your personal integrations", click "+ Add integration".
Sally sidebar with Integrations selected and the Add integration button highlighted
Open Integrations and add a new one
  1. In the integration drawer, find "Sally MCP" and click "Create Token".
Integration drawer with Sally MCP entry and Create Token button highlighted
Pick Sally MCP
  1. Fill out the "Create new Sally MCP Token" dialog:

    • Name: a label that helps you recognize the token later (e.g. "Langdock").
    • Expires: choose a lifetime: 30 days, 90 days, 1 year, 2 years, or Never.

    Then click "Create Token".

Create Sally MCP Token dialog with label Langdock and Expires field
Name the token and pick a lifetime
  1. Sally displays the full token exactly once. Copy it immediately and store it in a password manager or secure secret store. Once you close the dialog, the clear-text value is gone: you cannot view it again, only regenerate it.
Treat the token like a password

The token grants read access to every appointment, recording, and summary your Sally user sees in this company account. Do not paste it into Slack, email, or tickets. Store it in a password manager.

Dialog showing the generated Sally MCP token with a copy button and a warning that the token is shown only once
Copy the token before closing the dialog
  1. Click "Done".

You can return to Settings → Integrations → Sally MCP → "Manage Tokens" at any time to regenerate, revoke, or create additional tokens. Regenerating invalidates the old token immediately, so update it in any client that still uses it.

Sally MCP Tokens manage dialog showing an active token with its prefix, expiry date, regenerate and delete icons
Manage active tokens: regenerate or revoke individually

2. Set Up the MCP Connection in Langdock

  1. In Langdock, click Integrations in the left sidebar.
  2. Click Add Integration in the top right.
  3. Select Create New from the dropdown.
Langdock integrations page with the Add Integration dropdown open and Create New option highlighted
Open Integrations and create a new one

In the "Add Integration" dialog:

  1. Select MCP Server verbinden as the type.
  2. Enter the following Server URL:
    https://app.sally.io/api/v1/McpExternal
  3. Select API Key as the authentication method.
  4. Click Create and connect.
Add Integration dialog with MCP Server type selected, Server URL field filled with the Sally endpoint, and API Key authentication chosen
Select MCP Server, enter the Sally endpoint URL, and choose API Key authentication

The "Set up your New Integration connection" dialog opens:

  1. Enter a Name for the connection (e.g. "Sally MCP").
  2. In the API Key field, paste your Sally token in this format:
    Bearer sally_pat_YOURTOKEN
Important: Bearer prefix required

The token must be prefixed with Bearer (including the trailing space). Without this prefix, Sally rejects the request with "401 Unauthorized".

  1. Click Save.
Set up your New Integration connection dialog with Name field showing Sally MCP and API Key field filled
Enter a name and paste the API key with Bearer prefix

You are now on the "MCP Client konfigurieren" page:

  1. Click Test Connection.
  2. If the connection is successful, a green "Connection successful" indicator appears next to the button.
  3. Under Available Tools, the Sally MCP tools are displayed (currently 5: Search appointments, Get recordings, Get summary, Search summaries, ...).
  4. Check Activate action for each tool you want to enable (all are activated by default).
  5. Optionally enable Request confirmation if users should manually approve each tool call before it runs.
  6. Click Save in the top right.
Up to 50 tools per integration

Langdock supports up to 50 tools per integration simultaneously.

MCP Client configuration page showing a successful connection test and a list of available Sally tools with activation checkboxes
Test the connection, then activate the desired tools and save
  1. Open a new chat or continue an existing one.
  2. Type @ in the input field. The Sally integration and its tools appear in the selection list.
  3. Mention the integration with @Sally MCP or simply ask a natural question, for example:

"What was discussed in my last meeting?"

The model automatically calls the relevant Sally tools (e.g. Get recordings, Get summary) and returns a summary.

Langdock chat showing a query mentioning @Sally MCP, with the model calling Get recordings and Get summary tools to return a meeting summary
Use @Sally MCP in any chat to query meeting data
Use in Agents

You can also add the Sally integration to the instructions of a Langdock Agent. The agent will then use it automatically for relevant queries without the user having to mention @Sally MCP.


3. Troubleshooting

IssueFix
Connection test fails with "401 Unauthorized"The Bearer prefix (with space) is missing before the token, or the token has been revoked. Correct the API Key value or create a new token at app.sally.io.
Connection successful but no tools visibleScroll down in the "Available Tools" section. If the list is truly empty, contact Sally support to verify MCP protocol compatibility.
Other workspace members cannot use the integrationBy default, the integration is only visible to the person who created it. As an admin, change the visibility to the entire workspace in the integration settings.

For more troubleshooting tips, see the General Setup Guide → Troubleshooting.