Connect Onedesk to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.
Ask your agent in plain language. Each of these maps to a real tool on the server.
Use the search work items tool in Onedesk
Use the get organization info tool in Onedesk
Use the create user tool in Onedesk
Use the create work item tool in Onedesk
Use the create project tool in Onedesk
Use the search projects tool in Onedesk
Supported Tools
search_items
Search Work Items
Searches for work items (tickets, tasks, etc.) using filter criteria.
Supports filtering by name, creation time, status, and custom fields.
Use operations like EQ (equals), CONTAINS, GT/LT (greater/less than) for flexible querying.
get_organization
Get Organization Info
Retrieves organization profile and policy information from OneDesk.
Returns the organization's configuration including available item types, container types, and user types.
Useful for discovering type identifiers needed when creating items, projects, or users.
create_user
Create User
Creates a new internal user in OneDesk.
Use this for internal team members (agents).
Specify the user type and optionally assign them to teams.
create_item
Create Work Item
Creates a new work item (ticket, task, or other configurable item type) in OneDesk.
Use this to submit tickets, create tasks, or add any other type of work item to a project.
Supports setting priority, description, type, and associating the item with a project.
create_project
Create Project
Creates a new project in OneDesk.
Projects are containers for organizing work items like tickets and tasks.
Optionally assign a parent portfolio and project type.
search_projects
Search Projects
Searches for projects using filter criteria.
Supports filtering by name, creation time, due date, invoice type, and custom fields.
Returns matching projects with their full details.
create_message
Create Message
Creates a message or comment on a conversation in OneDesk.
Use this to add comments to tickets, tasks, or other work items via their conversation ID.
Message visibility follows the existing conversation.
get_item
Get Work Item
Retrieves a single work item by its internal ID or external ID.
Returns full details of the item including name, description, status, priority, assignees, and custom fields.
update_item
Update Work Item
Updates an existing work item in OneDesk by its numeric internal ID or external ID. External ID lookup requires an API key connection.
Modify the name, description, priority, or completion percentage of a ticket, task, or other item type.
get_project
Get Project
Retrieve project details by external ID. Use the ID returned by create_project or discover it with search_projects. Requires an API key connection.
search_teams
Search Teams
Discover teams and their external IDs with detailed results. Requires an API key connection.
search_users
Search Users
Discover users and their external IDs with detailed results. Requires an API key connection.
Enable Onedesk in Metorial. In your Metorial portal, enable the Onedesk MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
Sign in. Select Add and sign in to load Onedesk tools.
Enable Onedesk in Metorial. In your Metorial portal, enable the Onedesk MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add a custom MCP server. On ChatGPT web, open Plugins, select +, then Add custom MCP server.
Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>), choose OAuth and accept the risk notice.
Create and install the plugin. Select Create as a plugin, install it and sign in to load Onedesk tools.
Enable Onedesk in Metorial. In your Metorial portal, enable the Onedesk MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add Metorial to your MCP config. Use ~/.cursor/mcp.json for every project, or .cursor/mcp.json for one.
Sign in. Open Customize in the sidebar, find Metorial and sign in to load Onedesk tools.
{
"mcpServers":{
"metorial":{
"url":"<your-magic-mcp-url>"
}
}
}
Enable Onedesk in Metorial. In your Metorial portal, enable the Onedesk MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add the server over HTTP. Add --scope user to use it in every project.
Sign in. Run /mcp, select Metorial and sign in to load Onedesk tools.
claude mcp add --transport http metorial <your-magic-mcp-url>
Enable Onedesk in Metorial. In your Metorial portal, enable the Onedesk MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add the server and sign in. The Codex CLI, IDE extension and ChatGPT desktop app share this config.
Check the connection. Type /mcp in Codex to see Metorial and its Onedesk tools.
codex mcp add metorial --url <your-magic-mcp-url>
codex mcp login metorial
Run Onedesk through the Metorial gateway
One governed layer for every app your agents reach, not a separate connector per tool.
Give Onedesk and every other app to your whole team through one MCP gateway, behind your SSO.
Scope which teams and agents can use Onedesk tools with role-based access control, and trace every call.
Prefer to run it yourself? Metorial is open source and self-hostable.
Create, update, and search for tickets, tasks, and other work items with custom fields, priorities, and assignments. Manage projects and portfolios hierarchically. Track time with timesheets and work logs. Create and manage invoices and quotes. Handle customer and organization records. Add internal comments and public-facing messages to work items. Search and filter across items, projects, and entities using property-based conditions.
Frequently asked questions
Common questions about connecting Onedesk to AI agents with Metorial.
How many tools does the Onedesk MCP server have?
The Onedesk MCP server exposes 12 tools, including Search Work Items, Get Organization Info, Create User. Each one is governed and traced through Metorial.
Does the Onedesk MCP server support triggers?
Onedesk exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
Which AI clients can use the Onedesk MCP server?
Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Onedesk MCP server through the same Metorial URL.
How do I give only some teams access to Onedesk?
Use role-based access control to decide which teams, users, and agents can use Onedesk and which of its tools they can call.
Can I self-host the Onedesk MCP server?
Yes. Metorial is open source, so you can run the Onedesk MCP server yourself or use the hosted gateway.
Connect Onedesk to production AI agents
See how Metorial gives your team governed access to Onedesk, with tracing and security controls built in.