Step 1: Go to the Playground Section
Show Content
Show Content
Navigate to Maestro Playground from the left-hand menu in AI21 Studio.
Step 2: Add a Tool
Show Content
Show Content
In the Configuration panel, go to the Tools section and click Add.
Step 3: Select MCP
Show Content
Show Content
In the tools dropdown, select MCP.
Step 4: Fill in the Fields
Show Content
Show Content
4.1 Add a URL
Enter the MCP server address in the URL field.
4.2 Add a Label
Enter a descriptive Label to identify the MCP server.
From the Authentication dropdown, select the authentication method (for example, API key or access token) and provide the credentials.
Enter the MCP server address in the URL field.
Handling “Invalid URL” Errors
If you see the “Invalid URL” error when adding your MCP server in AI21 Studio, it usually means:
For full setup instructions, see the MCP Server Setup guide.
If you see the “Invalid URL” error when adding your MCP server in AI21 Studio, it usually means:
- The server is using
http://instead ofhttps:// - The server is running on a raw IP address and isn’t exposed as a public HTTPS endpoint
For full setup instructions, see the MCP Server Setup guide.
4.2 Add a Label
Enter a descriptive Label to identify the MCP server.
From the Authentication dropdown, select the authentication method (for example, API key or access token) and provide the credentials.
Authorization headers are not saved with the agent. If you save the agent, the headers will not be stored. When you reload the agent, you’ll need to enter the authorization headers again.
Step 5: Review Allowed Tools
Show Content
Show Content
Click Review allowed tools.
Step 6: Save the Tools
Step 7 (Optional): Edit MCP Tools
Show Content
Show Content
Edit an existing MCP tool by following these steps:
- Click the ⋮ (colon icon).
- Select Edit, make your changes, and click Save.