> ## Documentation Index > Fetch the complete documentation index at: https://www.truefoundry.com/llms.txt > Use this file to discover all available pages before exploring further. # Set up Slack Managed MCP Server > Connect Slack as a fully managed MCP server on the TrueFoundry MCP Gateway so agents can search, read, and send messages, and work with channels and canvases. [Slack](https://slack.com) is a messaging platform for teams. TrueFoundry ships it as a fully managed MCP server, so your agents can search conversations, read channels and threads, send messages, and work with canvases without any infrastructure setup on your end. You add it from the TrueFoundry catalog, authorize once via OAuth2, and the endpoint is immediately available to every MCP-compatible client you use. Slack is provisioned as a TrueFoundry Managed MCP — the platform manages its URL, auth, scopes, and credentials. For how managed servers are provisioned and kept up to date, see [TrueFoundry Managed MCPs](https://www.truefoundry.com/docs/ai-gateway/mcp/tfy-managed-mcp-server.md). To register your own Slack app instead, see [Slack MCP Server](https://www.truefoundry.com/docs/ai-gateway/mcp/slack-mcp-server.md). ## How TrueFoundry Manages the MCP Server TrueFoundry's MCP Gateway acts as a reverse proxy between your agents and MCP servers like Slack. When you add Slack as a managed MCP, TrueFoundry handles: * **Authentication** — Agents authenticate once to the TrueFoundry MCP Gateway. The AI Gateway handles outbound auth to Slack. Authorization happens directly between your account and your Slack workspace through the OAuth2 flow; TrueFoundry does not receive your Slack credentials. * **Tool-level access control** — You can selectively enable or disable individual Slack tools per team from the TrueFoundry UI. * **Audit trail** — Every tool invocation is traced with the calling user, tool name, input payload, and latency. Traces export via OpenTelemetry to your observability stack. * **Guardrails** — TrueFoundry's guardrail hooks apply at `mcp_pre_tool` (before a tool is invoked) and `mcp_post_tool` (after the tool returns), letting you enforce content policies on Slack requests and results in real time. ## Adding Slack to TrueFoundry **1. Open the MCP Server catalog** Navigate to **MCP Servers** in the TrueFoundry sidebar and click **Add new MCP Server**. On the next screen, select **Connect TrueFoundry Managed MCPs** — this opens the catalog of pre-vetted, fully configured MCP servers managed by TrueFoundry. ![Add new MCP Server picker with the Connect TrueFoundry Managed MCPs option at the top](https://mintcdn.com/truefoundry/NVj6cqQd0dxUA9RQ/images/docs/ai-gateway/tfy-managed/tfy-managed-tab.png?fit=max\&auto=format\&n=NVj6cqQd0dxUA9RQ\&q=85\&s=9f04f676bcb9608acdb3c4b3b2b1a359) **2. Add Slack** Click **+ Add** on **Slack**. It appears as **Slack \[Managed]** in your MCP Servers list. ![MCP Servers list with Slack \[Managed\] at the top](https://mintcdn.com/truefoundry/7egE624gNqhuOe0e/images/docs/ai-gateway/slack-managed-catalog.png?fit=max\&auto=format\&n=7egE624gNqhuOe0e\&q=85\&s=618ee6b865085af5d1c2b3abbdd53a3b) **3. Authenticate** The Tools tab shows that you're not connected yet. Click **Connect Now**. ![Slack Managed MCP server detail page with the Tools tab showing You're not connected and a Connect Now button](https://mintcdn.com/truefoundry/7egE624gNqhuOe0e/images/docs/ai-gateway/slack-managed-connect.png?fit=max\&auto=format\&n=7egE624gNqhuOe0e\&q=85\&s=e611ed07ee1e2a8d84a8b74c5a0b6c95) An authorization popup appears showing the MCP client name, the TrueFoundry website, and the redirect URI (`https://auth.truefoundry.com/mcp/oauth2/callback`). Review the details and click **Approve** — you'll then be redirected to authenticate with your Slack workspace and grant access. > [!NOTE] > > TrueFoundry does not receive your Slack credentials — the authorization is between your account and Slack directly. ![OAuth authorization popup requesting access, showing the redirect URI and an Approve button before redirecting to the Slack workspace](https://mintcdn.com/truefoundry/7egE624gNqhuOe0e/images/docs/ai-gateway/slack-managed-oauth-approve.png?fit=max\&auto=format\&n=7egE624gNqhuOe0e\&q=85\&s=3ee7a4a7f92751db0b8e4254bee883c0) **4. Verify tools** After approving, the **Tools** tab populates with Slack's available tools — searching messages and users, reading channels and threads, sending and scheduling messages, and working with canvases. Each tool shows its description and a **Try** button so you can test it before wiring it into an agent. Tools are labeled **Read-only** or **Destructive** so you can see at a glance which ones modify data. ![Slack Tools tab populated with the available tools after a successful OAuth2 connection, each labeled Read-only or Destructive](https://mintcdn.com/truefoundry/7egE624gNqhuOe0e/images/docs/ai-gateway/slack-managed-tools-list.png?fit=max\&auto=format\&n=7egE624gNqhuOe0e\&q=85\&s=512d5da4e3f2b010182a1f84a19fd241) ## Available Tools The Slack managed MCP server exposes the following tools. Each tool acts with the permissions of the Slack user who authorized the connection, so agents can only see and do what that user can. | Tool | Type | Description | | - | - | - | | `slack_search_public` | Read-only | Search messages and files in public channels | | `slack_search_public_and_private` | Read-only | Search messages and files in all channels, including private channels, DMs, and group DMs | | `slack_search_channels` | Read-only | Search channels by name or description | | `slack_search_users` | Read-only | Search users by name, email, or profile attributes | | `slack_search_emojis` | Read-only | Search emojis available in the workspace | | `slack_read_channel` | Read-only | Read messages from a channel or DM, newest first | | `slack_read_thread` | Read-only | Read the replies in a message thread | | `slack_read_canvas` | Read-only | Read the content of a canvas | | `slack_read_file` | Read-only | Read a file shared in Slack | | `slack_read_user_profile` | Read-only | Read a user's profile | | `slack_list_channel_members` | Read-only | List the members of a channel | | `slack_get_reactions` | Read-only | Get the reactions on a message | | `slack_send_message` | — | Send a message to a channel or user | | `slack_send_message_draft` | — | Create a message draft for the user to review and send | | `slack_schedule_message` | — | Schedule a message for future delivery | | `slack_add_reaction` | — | Add an emoji reaction to a message | | `slack_create_conversation` | — | Create a channel, DM, or group DM | | `slack_create_canvas` | — | Create a canvas from Markdown | | `slack_update_canvas` | Destructive | Update the content of an existing canvas | ## Connecting to an MCP Client TrueFoundry exposes the Slack MCP server over HTTP transport. The endpoint is specific to your TrueFoundry tenant, so don't construct it by hand — copy the exact URL and ready-to-paste connection commands from the **How To Use** tab on the Slack server detail page. The How To Use tab generates connection instructions for every major client, including Cursor, VS Code, Claude Code, Claude Web, Claude Desktop, Windsurf, Codex, and the Python and TypeScript MCP SDKs. Pick your client, copy the snippet, and paste it in. Click **Show API Key** on that tab to retrieve the API key if your client requires it as a header. ![Slack How To Use tab showing connection commands for multiple MCP clients](https://mintcdn.com/truefoundry/7egE624gNqhuOe0e/images/docs/ai-gateway/slack-managed-how-to-use.png?fit=max\&auto=format\&n=7egE624gNqhuOe0e\&q=85\&s=d7225158933b469d3cd618b30cdf105c) ## Using Slack from an Agent Once connected, ask your agent to work with Slack in plain language. For example: * "Summarize what was discussed in #release-planning this week." * "Find the latest thread about the on-call handoff and post a short update in #eng-oncall." * "Create a canvas with the action items from today's standup." The agent picks the matching Slack tools, and every call is recorded in the audit trail. ## Using the Tool Playground Before deploying an agent, you can test any Slack tool directly in TrueFoundry: **1. Open a tool** On the Slack MCP server detail page, click **Try** next to any tool — for example `slack_search_channels`. **2. Fill in the inputs** Provide the tool's inputs. For `slack_search_channels`, enter a search term such as `engineering`. **3. Execute and inspect** Click **Execute Tool** and inspect the JSON output in the right panel. ## Tool Metrics The **Metrics** tab on the Slack server detail page shows per-tool usage data: invocation count, latency distribution, and error rates. Use this to monitor which tools your agents are using and whether any tool is producing errors in production. ## Disabling Individual Tools If your use case only needs a subset of Slack's tools, you can disable the rest from the Tools tab. Each tool has a toggle to enable or disable it. Disabled tools are not callable by agents — they will not appear in the tool list returned to the MCP client. This reduces the tool surface exposed to the agent and avoids unnecessary calls — for example, disabling `slack_send_message` and `slack_update_canvas` to keep an agent read-only. ## Disconnecting Slack To remove your authorization, click **Disconnect** at the top of the Slack server detail page. TrueFoundry deletes your stored tokens and agents can no longer call Slack tools on your behalf until you connect again. To also revoke the grant on Slack's side, remove the app from your workspace's **Manage apps** page in Slack. Tenant admins can remove every user's stored credentials at once with [Revoke all tokens](https://www.truefoundry.com/docs/ai-gateway/mcp/mcp-gateway-auth-security.md#revoking-all-tokens). ## Data and Privacy TrueFoundry uses the data returned by Slack only to carry out the tool calls your agents make, and does not use it to train AI models. For details on what is collected and how long it is kept, see the [TrueFoundry Privacy Policy](https://www.truefoundry.com/privacy-policy). This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.