Overview
This page describes the steps to use Josys MCP with Claude.
Reference: Josys MCP - Quick Start Guide
Prerequisites
To use Josys MCP from Claude Desktop, you need the following:
- Claude Desktop
- Node.js version 20 or higher
- Josys Super Admin privileges
- Access token for Josys MCP
About Node.js
Node.js is used to connect Claude Desktop to Josys MCP.
If Node.js is not installed, please install it beforehand.
Steps
- Log in to Josys.
- Click "Settings" > "Developer" in the bottom left of Josys.
- 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 displayed again once you close the page.
- Launch Claude Desktop.
- Open [Settings].
- Click [Developer] > [Edit Config].
- File Explorer will open with claude_desktop_config.json selected. Open this file.
- Scroll to the bottom and update it as follows.
How to Update
- Delete the closing brace "}" at the very end of the file.
- Copy the following code, replace
PASTE_YOUR_ACCESS_TOKEN_HEREwith the token you obtained earlier, paste it at the end of the file, save, and close the file.
"mcpServers": {
"JOSYS": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.us.josys.it/mcp",
"--header",
"x-agent-token:${AGENT_TOKEN}"
],
"env": {
"AGENT_TOKEN": "PASTE_YOUR_ACCESS_TOKEN_HERE"
}
}
}Please refer to the table below and change the URL portion as appropriate.
| 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 |
Actually Using It with Claude
- Close Claude and launch it again.
- Once the chat opens, ask your question.
Claude may ask for permission to access the MCP server. Please grant permission when prompted.