Tool Gateway is in beta.
Before you begin
You need:- A LangSmith Plus or Enterprise plan.
- A workspace role that can add servers. Workspace Admins and Workspace Editors can both add personal servers.
- A personal access token. Creating servers and tool kits requires a user credential. A service key does not work for these steps.
- Your workspace ID. Every API request sends it in the
X-Tenant-Idheader. - Accounts on two services that offer a remote MCP server. This quickstart uses Linear and Notion. To use other services, substitute their MCP URLs and tool names. If you follow the Linear example, use a test Linear workspace, because the kit includes a tool that can create issues.
- An MCP client that supports Streamable HTTP and lets you set a custom header, which carries your LangSmith API key. This quickstart uses Claude Code. To call the tools without a client, you can send HTTP requests with
curlinstead. - jq, if you follow the API steps. The commands use it to save IDs from each response.
LANGSMITH_ENDPOINT to your region’s URL from Base URL.
200 when your setup works.
Step 1. Add MCP servers
Register each MCP server once, along with the kind of credential it needs. Both example servers, Linear and Notion, use OAuth.- UI
- API
- In LangSmith, go to Tools > MCP servers.
- Select Personal, then click Add MCP server.
- Enter
Linearas the name andhttps://mcp.linear.app/mcpas the URL, and select OAuth. - Repeat for Notion, with the URL
https://mcp.notion.com/mcp.
Step 2. Connect your accounts
Sign in to each service once. Tool Gateway stores your tokens and attaches them to every later call that acts as you. Calls from an MCP client that uses your API key act as you.- UI
- API
- On Tools > MCP servers, click Connect on the Linear row.
- In the tab that opens, approve access in Linear. A LangSmith page confirms that authentication succeeded.
- Repeat for Notion.
This quickstart connects your own accounts. To connect credentials for an agent, a profile, or the whole workspace, see Connect accounts.
Step 3. Create a tool kit
A tool kit is a curated set of tools, from any number of servers, that Tool Gateway serves to an agent at one MCP URL. This kit holds Linear’slist_issues and save_issue tools and Notion’s notion-search tool.
- UI
- API
- Go to Tools > Tool kits and click Create tool kit.
- Enter
Quickstart kitas the name, and set who can use it to Personal. - In the tool picker, filter by server and select
list_issuesandsave_issuefrom Linear andnotion-searchfrom Notion. - Click Review tool selection, then Create tool kit.
/kits/ in that URL. Save it:Quickstart kit is taken, choose another name.
Step 4. Call tools from an MCP client
A tool kit is a standard Streamable HTTP MCP endpoint. Your agent or coding assistant connects to it as an MCP client. The client sends your LangSmith API key, and Tool Gateway attaches your stored Linear and Notion tokens to each call.- Claude Code
- HTTP
Add the kit to Claude Code, with your API key in the Run
X-Api-Key header:claude mcp list and confirm that quickstart-kit shows as connected. Then start Claude Code, and ask it to search Notion for a topic, or to list your Linear issues. Each call runs on the service with your account.The kit’s panel on Tools > Tool kits shows this command with your kit’s URL filled in. It also shows setup for Cursor and Managed Deep Agents. For other clients, see Connect an MCP client.Next steps
You now have one MCP URL that serves tools from two services, each called with your own account, without any authentication code in your client. Everything in this quickstart was personal. Tool Gateway is most useful when you share this setup:- Register servers once for the whole workspace, or turn on built-in servers.
- Give each agent a kit with only the tools it needs.
- Let every user or agent connect their own account, and choose whose credentials each call uses.
- Set policies and record traces, so you control and can review every tool call.
Connect these docs to your agent of choice via MCP for real-time answers.

