Connect Joinways to Claude (MCP)

Connect Joinways to Claude (MCP)

The Joinways MCP connector lets Claude — whether you use it on claude.ai, Claude Desktop, Claude Code or any other client that supports MCP — work directly with your Joinways workspace from inside a regular conversation. You no longer have to switch between Joinways and a chat window: Claude can read your leads, draft quotes, update events, send emails on your behalf and brief you on what's coming up, all using natural language.

This article explains what MCP is, what the Joinways connector lets Claude do, how to install and authorize it in less than three minutes, and how to get the most out of it once it's running.

At a glance. Available on every paid plan, takes ~3 minutes to install, runs over an authenticated OAuth-style flow, and respects your existing Joinways permissions. Claude can only see and act on what your account can already see and act on.

What is MCP?

MCP (Model Context Protocol) is the open standard that lets large language models like Claude connect to external tools and data. A connector — sometimes called an "MCP server" — exposes a set of capabilities (read leads, list events, send an email, etc.) that Claude can invoke when it's helpful for your request.

Concretely:

• The connector lives on Joinways' side. You don't install software on your machine.
• Claude calls it through your authorized session, so Joinways always sees a real, signed-in user.
• Every call is auditable in Joinways' activity log, just like a manual action.

If you've used "Tools" in ChatGPT, "Plugins" in older Claude versions, or "Actions" in Notion AI, MCP is the modern, open equivalent — but more capable, since it lets the model do multi-step workflows in a single conversation.

What Claude can do with the Joinways connector

Once the connector is enabled in Claude, you can ask things like the examples below and Claude will execute them by talking to Joinways for you.

Inquiries and leads

• "What new leads came in this week?" — Claude lists recent leads, sorted by date, with the AI-extracted event type, date and headcount.
• "Qualify the wedding inquiry from Camille Martin — does the date work in our castle, and what's a fair budget anchor?" — Claude checks availability, compares to past similar events, and suggests a budget range.
• "Draft a reply to the seminar request that came in yesterday." — Claude prepares a personalized reply in your tone, ready for you to review and send.

Events and calendar

• "Show me everything happening at Château de Beauregard between June 14 and June 21." — Claude pulls the calendar view filtered by venue.
• "Create an event for the Dupont 50th birthday on October 12, 60 guests, in the Grande Salle." — Claude creates the event with the correct status (Option), assigns the space and links the contact.
• "Find me events without a signed quote that start in the next 30 days." — Claude lists items that need attention so you can chase them.

Quotes and BEOs

• "Build a quote for the Martin wedding: 120 guests, two-course dinner, room rental, DJ." — Claude assembles line items from your catalog and produces a draft quote in the Quotes tab.
• "Update the BEO for Saturday — the bride asked for a vegetarian option for table 4." — Claude finds the right event, opens the BEO, and inserts the dietary note.
• "Send a polite reminder to the contacts who haven't signed their quote yet." — Claude drafts and queues an individual email per pending contact.

Reports and admin

• "How did our conversion rate compare to last quarter?" — Claude pulls Reports → Commercial and summarizes the change.
• "Show me the team members who haven't connected their email yet." — Claude lists the gaps.
• "Add Sarah Lebrun as a Manager on the Beauregard workspace." — Claude opens the invitation flow and confirms with you before sending.

Important — Claude never acts blindly. For any operation that changes data (creating, updating, deleting, sending), Claude shows you a preview and asks for confirmation before executing. Read-only operations (listing, summarizing) can run without confirmation, depending on your client's settings.

Install the connector

Setup happens in two places: in Joinways, you generate the connector URL once; in your Claude client, you add that URL and authorize the connection.

Step 1 — Generate the connector URL in Joinways

1. Open Settings → Integrations → API.
2. Joinways shows you a unique URL of the form https://mcp.joinways.com/. Copy it; you'll paste it into Claude next.

Step 2 — Add the connector in Claude

The exact path depends on which Claude client you use.

• Claude Desktop — open Settings → Connectors → Add custom connector, paste the URL, and sign in to Joinways when the OAuth popup appears.
• Claude.ai — open Settings → Connectors → Add MCP server, paste the URL, name it "Joinways", and authorize.
• Claude Code — in your project, run claude mcp add joinways <url> and accept the authorization prompt. The connector is then available on this machine in any Claude Code conversation.

After authorization, send a quick test prompt to confirm everything is wired:

"Hi Claude, can you confirm you can see my Joinways workspace and list my next three events?"

If Claude replies with a real list, you're done.

Step 3 — Permissions and visibility

The connector inherits your Joinways role:

• Admin — full read/write across the workspace.
• Manager — read/write on assigned venues, read-only on others.
• Member — read/write only on events you own.

If you can't do something in the Joinways UI, Claude can't do it either through the connector. This is intentional: the MCP layer never elevates permissions.

Best practices

• Be specific in your prompts. "List my leads" works, but "Show me leads received this week, sorted by event date, with the AI-extracted budget" gives a much sharper answer.
• Use Claude for the boring stuff. Daily inbox triage, follow-up drafting, batch updates and weekly recap reports are where you get the biggest time savings.
• Keep one connector per workspace. If you manage multiple workspaces, add each as a separate connector. Naming them clearly ("Joinways – Château", "Joinways – Domaine") avoids confusion.
• Pair the connector with calendars. If Google Calendar or Outlook Calendar is also synced, Claude can answer questions like "Am I free Saturday evening?" by combining both data sources.

Curious how others use it? The most popular workflows we see are Monday morning briefing ("What's on this week, what's still in option?"), Inbox zero ("Reply to every lead from yesterday with a personalized first response"), and Quote follow-up ("Chase signed-quote candidates from the last 14 days").

Troubleshooting

Claude says it can't see my Joinways data

Re-authorize the connector: in your Claude client, remove the Joinways MCP server, then re-add it using the URL from Settings → Integrations → API. Most "I can't see anything" issues are stale tokens.

Claude takes actions I didn't approve

This shouldn't happen for write operations. If it does, check your client's connector settings — some clients have an "always allow" toggle that you may have enabled. Switch it back to "ask before each action".

The MCP URL is broken or expired

Tokens are rotated when an admin clicks Revoke in Settings → Integrations → API. Generate a new URL and reconfigure your client.

Claude can't find a specific event

Make sure you give it enough context: a name, a date or a venue. If your workspace has multiple events with similar titles, Claude will ask you to disambiguate.

Read-only mode keeps blocking writes

You're in restricted mode by design. Open Settings → Integrations → API, edit the connector, and grant write permissions for the capabilities you need.

Frequently asked questions

Is the connector free?

Yes, for every paid plan. The free trial includes it as well.

Does Anthropic see my Joinways data?

Anthropic processes the requests Claude needs to answer you, but your data is not used to train models when you use Claude in business contexts. Read Anthropic's privacy and data-handling pages for the exact policy. From Joinways' side, only the calls Claude needs to fulfill your request are made.

Can multiple users in my team use the same connector?

Each team member adds the connector with their own Joinways account, which preserves per-user permissions. You don't share a single token.

Does it work offline?

No. Both Claude and the Joinways connector require an internet connection.

Will it create events or send emails without me?

No. Every write action is preceded by a preview and a confirmation, unless you've explicitly switched your client to "always allow" mode.

What languages does Claude understand for Joinways prompts?

All major languages, including French, English, Spanish, German and Italian. The interface language of Joinways doesn't have to match the language you use with Claude.

Can I use the connector in Claude Code?

Yes. Once registered with claude mcp add joinways <url>, every Claude Code session on that machine can use it. This is particularly powerful for developers building automations on top of Joinways.

See also

• Quickstart Guide — set up your Joinways workspace first if you haven't yet.
• Email connections (Gmail / Outlook) — required if you want Claude to draft replies from your address.
• Reports & performance — the underlying metrics Claude surfaces in summaries.
• Security & access — how permissions and roles interact with the connector.

Connect Joinways to Claude via MCP

Below is a concise, ready-to-publish version of the instructions you provided, preserving structure and key details.

---

Connect Joinways to Claude (MCP)

The Joinways MCP connector lets Claude — on claude.ai, Claude Desktop, Claude Code or any other MCP-compatible client — work directly with your Joinways workspace from inside a regular conversation. Claude can read your leads, draft quotes, update events, send emails on your behalf and brief you on what’s coming up, all in natural language.

At a glance. Single endpoint at https://mcp.joinways.app. ~50 tools across events, leads, quotes, BEOs, emails, contacts, venues, catalog and analytics. Available on the Pro plan, ~3 minutes to install, OAuth 2.1 (recommended) or Personal Access Token. Claude only sees and acts on what your Joinways account already can.

---

About Joinways

Joinways is the all-in-one CRM built specifically for venues — châteaux, domaines, hotels, restaurants and event spaces. It centralizes inquiries from every channel (web forms, Instagram, WhatsApp, email), turns them into qualified leads, schedules events on a shared calendar, generates quotes and BEOs, and keeps the whole team aligned.

The MCP server makes that entire workspace addressable from your AI assistant of choice.