Overview
This page describes the steps to use Josys MCP in Cursor.
Reference: Josys MCP - Quick Start Guide
Prerequisites
Download the Cursor desktop app.
Steps
- Log in to Josys.
- In the bottom left of Josys, click "Settings" > "Developer".
- Click "+ Create" in the top right.
- When the pop-up appears, select "Access Token (for Josys MCP)".
We recommend using a unique label that helps identify who is using it and where. - Once created, the token will be displayed. Please copy and save it. Note that it will not be shown again once you close the page.
- Open the Cursor desktop app.
- Click "Add Tool or MCP" at the bottom of the Automations page.
- When the menu opens, hover over "MCP Server" and click "+New Connection".
- Click "Add a custom MCP".
- Enter the details as follows:
Server URL: https://mcp.josys.it/mcp
HTTP headers Key: x-agent-token
HTTP headers Value: The access token you just generated and saved from Josys - Click "Add MCP" in the bottom right.
Please modify the URL as appropriate by referring to the table below.
| Your Josys Login URL | MCP Server URL to Use |
|---|---|
| https://app.josys.it | https://mcp.josys.it/mcp |
| https://app.us.josys.it | https://mcp.us.josys.it/mcp |
Using in Cursor
- Click the "▲" button in the top right to run a test.
- Confirm that the information has been successfully retrieved.
Important Notes
In Teams / Enterprise plans, you may not be able to add MCP servers depending on your administrator's settings. In this case, please contact your organization's Cursor administrator.