Example of an MCP resource set up and using it in an Agent

[Alice]

The following is an example of an MCP resource (Linear) that you can use in your Retool Agents.

1. Create a free linear account with with the same email address you use as your Retool user (as we will use this for Oauth)
2. In Linear: Create your oauth app by going to settings (top left under your avatar) -> API -> Oauth Application -> new (yourWorkspaceURL/settings/api/applications/new)
3. Insert:

• App name
• Dev name
• Dev URL (any)
• Oauth callback URL (from the Retool resource set up page) and
• enable the client credentials toggle

Your set up in Linear will look something like this:

[Alice]

4. Click Create and note down client id and client secret
5. In your Retool resource insert the MCP server URL=https://mcp.linear.app/mcp (docs) and set up Oauth2

• Authorization URL =https://linear.app/oauth/authorize (docs)
• Access Token URL= https://api.linear.app/oauth/token (docs)
• Client id and Credentials as noted down earlier
• Scope=admin (for testing only - this allows you to do everything - in production environment you'd need to narrow the scope down)

Your Retool resource set up will look something like this:

Note when you test the connection and get error Workspace does not have access to this private application then try again in incognito - There may be issues with stale logins from the your company's linear environment (if you are testing with a free linear version).

[Alice]

6. Now create an agent and add the MCP Linear server as a Tool
   
   

Note that Require user confirmation before using tools will prompt for approval before the MCP resource is used, like here, and will only proceed after you click Approve

7. Now ask away