A guide to connected assistants

Connect your AI assistant

Bring your whisky collection into the conversation. Ask about bottles you own, explore your tasting notes or plan a flight with the assistant you already use.

MCP is the connection that lets your assistant read information from MyDrams. You use your own assistant account; availability and usage limits depend on the provider and your workspace.

ChatGPT · Illustrated walkthrough

Connect MyDrams to ChatGPT

Set this up in a web browser. This video shows the whole process in a free ChatGPT account. The process is also explained step by step with screenshots below.

  1. Open your settings

    Select your account name at the bottom left, then Settings.

    See screenshots
    Select your account name at the bottom left of ChatGPT
    Select your account name at the bottom left of ChatGPT. Select the image to open it full size.
    Choose Settings from the ChatGPT account menu
    Choose Settings from the ChatGPT account menu. Select the image to open it full size.

  2. Enable Developer mode if needed

    Choose Plugins → Developer mode. This opens the setting under Security and login. Read ChatGPT's explanation and turn Developer mode on if you want to add the custom connection. Close Settings when finished.

    Leave other security settings unchanged. If your workspace restricts custom connections, ask its administrator.

    See screenshots
    Choose Plugins in the ChatGPT settings sidebar
    Choose Plugins in the ChatGPT settings sidebar. Select the image to open it full size.
    Open Developer mode from the Plugins settings page
    Open Developer mode from the Plugins settings page. Select the image to open it full size.
    Developer mode enabled under Security and login; close Settings next
    Developer mode enabled under Security and login; close Settings next. Select the image to open it full size.

  3. Add the MyDrams server

    Open Plugins in the main sidebar. Select + → Add custom MCP server. If an upload dialog appears, select Create MCP App.

    See screenshots
    Open Plugins from the main ChatGPT sidebar
    Open Plugins from the main ChatGPT sidebar. Select the image to open it full size.
    Select Add custom MCP server from the plus menu
    Select Add custom MCP server from the plus menu. Select the image to open it full size.
    Choose Create MCP App if an upload dialog appears
    Choose Create MCP App if an upload dialog appears. Select the image to open it full size.
    Name
    MyDrams
    Connection
    Server URL
    Address
    Paste the MyDrams server address above.
    Authentication
    OAuth

    The icon and description are optional. Use the detected OAuth settings; if asked for a client setup method, choose automatic dynamic registration (DCR). No manually supplied client ID or secret is needed.

    Read the warning, acknowledge it if you wish to continue, and select Create.

    See screenshot
    New Plugin form with MyDrams, the production server URL and OAuth selected
    New Plugin form with MyDrams, the production server URL and OAuth selected. Select the image to open it full size.

  4. Connect your MyDrams account

    On the MyDrams plugin page, select Connect another account, even if this is your first connection. Choose Sign in with MyDrams and sign in if prompted.

    See screenshots
    Choose Connect another account on the MyDrams plugin page
    Choose Connect another account on the MyDrams plugin page. Select the image to open it full size.
    Choose Sign in with MyDrams to start account authorisation
    Choose Sign in with MyDrams to start account authorisation. Select the image to open it full size.

    On the consent page, check the MyDrams account and that the return destination is chatgpt.com. Read the permissions, then choose Allow if you agree.

    You may see Unverified app: MyDrams has not verified the identity behind the client's supplied name. Only continue for the connection you just started.

  5. Refresh the tools

    Back in ChatGPT, confirm your account appears under Connected accounts. If it says No app tools available yet, select Refresh. Wait for the tools to appear, then close Settings.

    See screenshots
    Connected account shown with Refresh highlighted below the empty tools list
    Connected account shown with Refresh highlighted below the empty tools list. Select the image to open it full size.
    The get_bottle read tool is available after refreshing; close Settings
    The get_bottle read tool is available after refreshing; close Settings. Select the image to open it full size.

  6. Ask about your collection

    Start a conversation and try this:

    Use MyDrams to show which bourbon bottles I have.

    If ChatGPT does not select MyDrams, type @ and choose the installed MyDrams plugin. If it is not installed yet, open your personal plugins and install it first. Review any tool permission request.

    Your answer will reflect your own collection.

    See screenshot
    Example ChatGPT answer showing bourbon bottles from a connected MyDrams collection
    Example ChatGPT answer showing bourbon bottles from a connected MyDrams collection. Select the image to open it full size.
OpenAI's current custom MCP instructions ↗

Claude · Quick setup

Connect MyDrams to Claude

Use Claude's web connector settings. On Team or Enterprise, an owner or authorised administrator may need to add the custom web connector under Organization settings → Connectors first. Each member then connects their own account.

  1. Add a custom connector

    Open Customize → Connectors, then + Add → Add custom connector. Enter MyDrams as the name and paste the server address above.

    Choose Continue and review the detected authentication settings. Use OAuth and Sign in now if asked. If offered an OAuth client choice, choose Register automatically. You do not need a client secret or request header.

    Finish adding the connector. Select Connect if Claude shows it as a separate action.

  2. Sign in and allow access

    Sign in to MyDrams if prompted. Check your account and return destination, read the permission details, then choose Allow if you agree. Only approve a connection you started.

  3. Use MyDrams in a conversation

    In a conversation, use the + → Connectors menu and enable MyDrams. Try:

    Use MyDrams to list my open bottles and suggest a three-bottle tasting flight.

    Review and save the suggested flight yourself in MyDrams.

Claude's current custom connector instructions ↗

Grok Bot · Quick setup

Connect MyDrams to Grok Bot

Grok Bot adds the server for you when you ask it in a chat.

  1. Ask Grok Bot to add the server

    Send this message:

    add https://mydrams.app/api/mcp as an mcp server

    Grok Bot adds it as mydrams and shows a card with an Authorize button.

    See screenshot
    Grok Bot adds the MyDrams server and shows a mydrams card with Authorize
    Grok Bot adds the MyDrams server and shows a mydrams card with Authorize. Select the image to open it full size.

  2. Authorise your MyDrams account

    Select Authorize on the mydrams card, then Continue. Sign in to MyDrams if prompted.

    The consent page will say Connect Cursor to MyDrams and return you to www.cursor.com. That is expected: Grok Bot and Cursor are both xAI products. Check that it shows your MyDrams account, read the permissions, then choose Allow if you agree. Only approve a connection you just started.

    See screenshot
    The Connect to mydrams dialog in Grok Bot with the Continue button
    The Connect to mydrams dialog in Grok Bot with the Continue button. Select the image to open it full size.

  3. Ask about your collection

    Try this:

    Do I have any American single malts from Texas?

    Grok Bot can also suggest a tasting flight and give you a link. Open it while signed in to MyDrams and select Save to create the flight.

    See screenshot
    Example Grok Bot answer listing Texas single malts and offering a tasting flight link
    Example Grok Bot answer listing Texas single malts and offering a tasting flight link. Select the image to open it full size.

Hermes Agent · Terminal setup

Connect MyDrams to Hermes Agent

Add the server from a terminal on the computer where Hermes runs.

  1. Add the server

    Run this command:

    hermes mcp add mydrams --url https://mydrams.app/api/mcp --auth oauth

  2. Sign in and allow access

    Your browser opens the MyDrams consent page. Sign in if prompted, check that it shows your MyDrams account and returns you to 127.0.0.1 (Hermes on your computer), then choose Allow if you agree.

    When the browser says the authorisation was successful, go back to the terminal. If no browser opens, open the link Hermes prints.

  3. Enable the tools

    Hermes lists the 12 MyDrams tools. Type y to enable them all. Then start a new Hermes session, or run /reload-mcp in an open one.

    See screenshot
    Terminal showing hermes mcp add connecting to MyDrams, listing 12 tools and saving the server
    Terminal showing hermes mcp add connecting to MyDrams, listing 12 tools and saving the server. Select the image to open it full size.

A few useful things to know

What else can I ask?
Try “What do my highest-rated tastings have in common?” or “Which bottles did I buy on my distillery visits?” Your assistant reads saved data; you save any new records yourself in MyDrams.
How do I disconnect?
Open MyDrams → Profile → Connected assistants and disconnect the provider. This stops future reads but cannot erase information already shared with the provider or kept in chat history.
Why can't I see my records?
Check which MyDrams account you authorised and that the connector is enabled in your conversation. In ChatGPT, refresh the tools if the list is empty.
What if connecting fails?
Check the server address and your provider's workspace permissions. Avoid repeated retries in quick succession; registration attempts are limited. For help, email whisky@mydrams.app.

Instructions and screenshots checked 9 October 2026. Provider menus may change. MyDrams privacy policy.

← Back to MyDrams