What this connection does
Claude Code can connect to the Requidex MCP server over streamable HTTP. After authentication, Claude Code can call read-only Requidex Open API tools and search Requidex Intercom help guides while you work in a coding session.
The connection uses OAuth. The Requidex MCP endpoint returns an authentication challenge when your token is missing, expired, or revoked, so Claude Code can start or refresh the sign-in flow.
Add the server
Run this command from a terminal where Claude Code is installed: `claude mcp add --transport http requidex https://api.requidex.com/mcp`
Authenticate
Start or return to Claude Code.
Run /mcp in the Claude Code session.
Select the Requidex server if prompted.
Follow the browser sign-in flow with an active, verified Requidex company admin account.
Return to Claude Code after authentication completes.
Check the connection
Run claude mcp list to confirm the Requidex server is configured.
Run claude mcp get requidex to inspect the saved server details.
Run /mcp inside Claude Code to view connection status and available tools.
Ask Claude Code to use the Requidex MCP server to list available Open API operations.
Using Requidex data
When prompts include company, project, agency, site, or trade names, Claude Code can use lookup tools to resolve those names to ids before calling filtered Open API tools.
For spend, total, count, ranking, top-N, or grouped analysis questions, Claude Code can use the relevant summary tool for invoices, assignments, timesheets, requisitions, expenses, or credit notes instead of fetching raw rows.
For list tools that support field selection, Claude Code can use the availableFields returned by list_open_api_operations or the fields shown in each tool description before setting the fields parameter.
For list tools that expose dateField, from and to apply to that selected date field. Use dateField when the user asks for start dates, end dates, week-ending dates, approval dates, confirmation dates, due dates, processed dates, or expense dates instead of creation dates.
Paginated tool calls default to 50 records, return at most 200 records per page, and can page through up to the first 10000 matching records. They include the total count so broad requests can be narrowed with filters. For count-only or existence checks on list tools, set limit=1 and read meta.total.
When the task is a product how-to, workflow, status, permission, setup, or troubleshooting question, Claude Code can use the search tool to find matching Requidex help guides and the fetch tool to read the full guide before answering.
Scope and storage
Claude Code stores MCP configuration according to the scope you choose. The default local scope is private to your current project. Use a user scope only if you want the Requidex server available across projects, and use project scope only when your team intentionally wants to share the server configuration.
Advanced filtering and aggregation
List and summary tools support multi-company filtering, and many tools support multi-ID filtering for documented entity filters such as project, site, trade, worker, assignment, timesheet, requisition, and agency. Pass comma-separated ids where the tool description allows it. For example, company='id1,id2,id3' returns data for all three companies instead of requiring three separate calls.
List tools that support the fields parameter accept dot-path nested fields as well as top-level fields. For example, fields='worker.id,values.charge.total,values.charge.wdBasic' returns only those nested timesheet fields instead of the full values object.
List tools that support dateField apply from and to to the selected date field. For example, use dateField='weekEnding' for timesheet week filters, dateField='dateAccepted' for requisition agency acceptance filters, and dateField='issueDate' for invoice issue-date billing periods.
All summary tools support multi-dimensional aggregation through the groupBy parameter and grouped result sorting through sortBy, sortOrder, and limit. Use groupBy to break down results by one or more dimensions such as company, trade, agency, purchaseOrder, status, category, or month. For example, groupBy='company,trade' returns spend per trade per company in one call instead of N×M separate calls, and groupBy='agency' with sortBy='finalTotal' and limit=5 returns the top five agencies by invoice value. Allowed values vary by endpoint and are documented in each summary tool description.
Timesheet summaries can group by worker, trade, and purchaseOrder, return distinctWorkers, and include charge and pay splits for weekday basic, weekday overtime, nightwork, weekend, and bank holiday values.
The recruitment metrics list tool can return server-side aggregates by setting metric='timeToFill' or metric='workersOverHours'. These modes support agency and period filters, groupBy values such as agency, project, month, and week, compound groupBy values such as company,agency, the IQR outlier rule for time-to-fill, and a configurable weekly hours threshold for workers-over-hours.
Combining multi-ID filtering with groupBy enables powerful cross-entity analysis. For example, summarize_assignments with company='id1,id2,id3' and groupBy='trade,month' returns assignment spend broken down by trade and month across three companies in a single API call.
Troubleshooting
If Claude Code reports that authentication is required, run /mcp and reconnect.
If authentication opens but fails, confirm your Requidex account is a company admin account.
If the server shows no tools, remove and re-add the server with --transport http and the exact URL https://api.requidex.com/mcp.
If prompts use the wrong source, name the server and tool family explicitly, for example: Use the Requidex MCP tools only.
For agencies
This connection signs in with the Requidex OAuth flow, which is available to hiring-company admin accounts. Agency and desk accounts cannot connect through this OAuth flow.
If you work for an agency and need programmatic access to your own data, ask your administrator about agency-scoped Open API keys instead of this connector.
Agency-scoped access is read-only and limited to the agencies you are connected to.
Some company-level endpoints, such as projects, trades, sites, and purchase orders, are not available to agency-scoped access.
