Skip to main content

Connect Claude Cowork (and other MCP clients) to LoyJoy

This guide shows how to wire LoyJoy into a Model Context Protocol (MCP) client so that the client can call LoyJoy tools directly. The detailed steps below are for the Claude Cowork desktop app; OpenAI ChatGPT Codex, Microsoft Cowork, Google Gemini, and any other compliant MCP client are set up the same way.

The LoyJoy MCP endpoint exposes tenant-wide tools (knowledge, processes, analytics) to the connected client. Authentication is handled via a regular Passkey login to your LoyJoy tenant; no API key or manual token management is required.

note

Looking for a single AI Agent exposed as an MCP server (per-agent URL with API-key auth) instead? See LoyJoy Agent as MCP Server for that use case.

Setup in 3 minutes: Claude Cowork​

Step by step with the Claude Cowork desktop app (Mac or Windows):

Adding a new connector in the Claude Cowork desktop app

  1. Open Settings — In the Claude Cowork desktop app (Mac or Windows), open Settings and navigate to "Connectors".
  2. Add a connector — Create a new custom connector, give it a name (for example "LoyJoy MCP"), enter https://app-cloud.loyjoy.com/mcp as the URL, and click "Add".
  3. Log in and get started — Claude Cowork opens the LoyJoy login screen. Sign in with your Passkey as usual; LoyJoy MCP is now available in Claude Cowork. A good first prompt: "Show me all tools from LoyJoy."

LoyJoy MCP in Claude Cowork after successful login

Setup for OpenAI ChatGPT with Codex​

The flow is identical: in the ChatGPT settings, open "Connectors", add a custom connector with the same URL https://app-cloud.loyjoy.com/mcp, authenticate against your LoyJoy tenant with your Passkey, and the Codex agent picks up the same MCP tools as Claude Cowork.

Setup for Microsoft Cowork, Google Gemini, and other MCP clients​

Microsoft Cowork, Google Gemini, and any compliant MCP client are configured the same way: add a custom MCP connector pointing to https://app-cloud.loyjoy.com/mcp and authenticate via Passkey. The available tools and their schemas are advertised by the LoyJoy MCP server itself and appear automatically once the connection is established.

What you can do next​

Once the connection is live, the client can call LoyJoy tools directly from the chat. Typical first prompts:

  • "Show me all AI Agents in my tenant."
  • "How many customer requests did agent X resolve end-to-end in the last 30 days?"
  • "List the most-used knowledge articles this month."

For more complex rollouts — SSO, team access concepts, or multiple tenants — a dedicated LoyJoy project manager guides the setup from the first idea through to go-live.