MCP Server Configuration
Configure and manage MCP servers in your Tray workspace to expose workflows and connector operations as AI tools.
Configure an MCP (Model Context Protocol) server in your workspace to expose Tray workflows and connector operations as tools for AI assistants.
You must be a workspace administrator to configure MCP servers.
Accessing MCP Server Settings
- Navigate to Workspace Settings (gear icon in top-right)
- Under AGENT GATEWAY in the left sidebar, click MCP Server
- Three tabs are available:
- MCP configuration - Server settings
- Workflow tools - Manage Composite Tools
- Connector tools - Manage connector operations
MCP Configuration Tab
Toggle Server Enabled to turn the MCP server on or off for this workspace.
Server Name: Identifier for your MCP server (e.g., "Demo - MCP / A2A MCP Server")
MCP Server URL: Automatically generated URL in format https://{workspace-id}.mcp.tray.ai. Copy this URL to configure AI clients.
Statistics (top of page):
- MCP SERVER: Enabled/Disabled status
- WORKFLOW TOOLS: Count of exposed Composite Tools
- CONNECTOR TOOLS: Count of exposed connector operations

Workflow Tools Tab
View and manage workflows exposed as Composite Tools.
Tool List:
- TOOL NAME - Workflow name as seen by AI clients
- STATUS - Enabled/Disabled indicator
- DETAILS - Tool description
- Actions menu (•••) - Manage individual tools

Use the search box to find specific tools. Click the actions menu (•••) to enable/disable or remove tools.
Connector Tools Tab
Expose individual connector operations as MCP tools.
Adding a Connector
- Click + Add connector
- Search or browse connectors by category

- Select a connector (e.g., Salesforce)
- In the "Manage operations" modal, select operations to expose

- Click Save
Managing Connectors
Once added, connectors display with:
- Connector name and icon
- Count of enabled operations
- Actions menu (•••) to manage operations or remove connector
Empty State
When no connectors are configured:

Click + Add connector to begin.
Best Practices
Tool Limits: Keep total tools under 15-20 for optimal LLM performance.
Tool Descriptions: Write clear descriptions that explain what the tool does, when to use it, and what inputs are required.
Security: Regularly review and remove unused tools. Only expose operations AI agents actually need.
Troubleshooting
Server won't enable: Verify Agent Gateway is enabled for your organization and you have workspace admin permissions.
Tools not appearing in AI client: Check server is enabled, tools have enabled status, AI client is configured with correct MCP Server URL, and API token has necessary permissions.
Next Steps
- Workflow Tools - Design Composite Tools
- Connector Tools - Select connector operations
- Connecting MCP Clients - Configure AI clients