Connect your AI assistant

You can connect an MCP-compatible AI assistant to your Moinho Novo member account to plan visits, check passes and prices, manage invoices and referrals, update your profile, and participate in community polls and the playlist.

Connect

1. Open Profile → AI assistants in the customer portal. This section appears when the connector is available.
2. Copy the server URL shown there (for Moinho Novo, https://moinho-novo.com/mcp).
3. In an assistant that supports remote MCP over Streamable HTTP with OAuth, add a custom connector using that URL.
4. Sign in with your Moinho ID and review the requested permissions.
5. Choose Connect, then return to your assistant.

The exact connector settings depend on your assistant. It must support OAuth authorization-code login with PKCE and dynamic client registration. You do not need to copy a password or browser session token into it.

Connections last up to 30 days. Your assistant can refresh its access during that period; afterwards, connect again.

Things to ask

• “How many day passes do I have left?”
• “Which desks are available next Thursday?”
• “Use one of my passes to book a desk on Thursday.”
• “What visits have I booked?”
• “Cancel my booking for next Tuesday.”
• “Put me on the waitlist for Friday if it is full.”
• “Find my invoices from last month.”
• “Move my Tuesday booking to Thursday.”
• “Find a desk with a monitor.”
• “Can I use one of my passes next Friday, and which pass expires first?”
• “What products and memberships are available to me?”
• “Email me my latest invoice again.”
• “Refer my friend and book their complimentary visit.”
• “Update my phone number and turn off automatic invoice emails.”
• “What polls can I vote in?”
• “Find this song and add it to the community playlist.”
• “Are any of my food or drink orders still pending?”

An assistant with a separate calendar integration can also combine your calendar with Moinho's availability.

Permissions and booking rules

• Read member information (member:read): your profile, subscriptions, passes, bookings, waitlist, invoices, referrals, pending orders, shop products, eligible polls and playlist, plus venue availability.
• Manage visits and waitlist (member:bookings): book using your passes or complimentary allowances, move or cancel eligible visits, and join or leave the waitlist.
• Resend invoices (member:invoices): email an invoice again to your account's billing contact.
• Manage referrals (member:referrals): refer new friends and book their complimentary visits, when you are eligible.
• Update profile (member:profile): change contact/billing details and preferences.
• Participate in the community (member:community): cast or replace poll votes and add Spotify tracks, subject to the usual eligibility and rate limits.

Existing connections keep their original permissions. Reconnect and approve the additional permissions to use the new actions. Clients may request any subset; only tools permitted by your connection appear.

The normal member-site rules apply. Booking uses an eligible pass or allowance. Availability is checked again when booking. Future day-pass bookings can be cancelled and their passes returned; same-day, past and subscription bookings cannot be cancelled through this connector. Visit dates use Europe/Lisbon.

Rescheduling follows the same restrictions and preserves your original booking if the new date or desk is unavailable. Pass eligibility follows the existing booking rules: expiry is checked when redeeming or moving a pass, and time-of-day windows are checked when booking for today. A balance or eligibility preview does not reserve a desk. Products can be browsed; purchasing continues through the customer shop.

Invoice date filters use UTC calendar days. Invoice totals are returned in cents for EUR. PDF links appear when available.

If an action's result is uncertain, ask the assistant to check your bookings and passes before trying a new action. Retrying the original request is supported.

Disconnect

Open Profile → AI assistants and select Disconnect beside the connection. Its access and refresh tokens stop working. Disconnecting does not cancel existing bookings.

Troubleshooting

• No AI assistants section: the connector has not been enabled for this installation.
• Sign-in cannot complete: use the Moinho ID linked to your member account, and start the connection again from your assistant. If the page says the account is not linked, ask reception to link it using the customer's Moinho ID action.
• Some actions are missing: your assistant has not requested their permission. Reconnect with the relevant scopes and refresh its tool catalog.
• Connection expired: reconnect through your assistant.