> ## Documentation Index
> Fetch the complete documentation index at: https://docs.allgoodhq.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Desktop

> Install the allGood Marketo MCP server as a custom connector in Claude Desktop so you can work with Marketo directly from a Claude conversation.

The allGood Marketo MCP server brings Mary's Marketo capabilities — looking up programs, emails, forms, and templates, cloning campaigns, uploading assets to Design Studio — directly into Claude Desktop. This setup takes about 5 minutes.

## Before you begin

You'll need:

* **Claude Desktop** installed (macOS or Windows)
* A Claude plan that supports custom connectors (Pro, Max, Team, or Enterprise)
* An **allGood account** with access to the Marketo integration
* The allGood Marketo MCP server URL: `https://api.allgoodhq.app/mcp/marketo`

<Note>
  Custom connectors aren't available on Claude's Free plan, and may need to be enabled by a workspace admin on Team or Enterprise plans.
</Note>

## Steps

<Steps>
  <Step id="open-connector-settings" title="Open connector settings">
    1. Open **Claude Desktop**
    2. Click your profile icon in the bottom-left corner and select **Settings**
    3. Go to the **Connectors** tab

    <Frame caption="Claude Desktop Settings window with the Connectors tab selected">
      <img src="https://mintcdn.com/allgoodtechnologyinc/nR16UlCzOGVbG_gR/images/use-cases/marketo-mcp/claude-desktop/connectors_tab.png?fit=max&auto=format&n=nR16UlCzOGVbG_gR&q=85&s=6997afdc0f79a429bc287b7b549d6683" alt="Claude Desktop Settings window with the Connectors tab selected" width="1972" height="1498" data-path="images/use-cases/marketo-mcp/claude-desktop/connectors_tab.png" />
    </Frame>
  </Step>

  <Step id="add-custom-connector" title="Add a custom connector">
    1. Scroll to the top of the Connectors list and click **Add > Add custom connector**

    <Frame caption="Connectors tab showing the Add menu with Add custom connector selected">
      <img src="https://mintcdn.com/allgoodtechnologyinc/nR16UlCzOGVbG_gR/images/use-cases/marketo-mcp/claude-desktop/add_custom_connector.png?fit=max&auto=format&n=nR16UlCzOGVbG_gR&q=85&s=8354d151907e932460ec221f59832f82" alt="Connectors tab showing the Add menu with Add custom connector selected" width="1970" height="1504" data-path="images/use-cases/marketo-mcp/claude-desktop/add_custom_connector.png" />
    </Frame>

    2. Fill in the connector details:
       * **Name**: `allGood Marketo`
       * **URL**: `https://api.allgoodhq.app/mcp/marketo`
    3. Click **Add**

    <Frame caption="Add custom connector dialog with name and URL fields filled in">
      <img src="https://mintcdn.com/allgoodtechnologyinc/nR16UlCzOGVbG_gR/images/use-cases/marketo-mcp/claude-desktop/custom_connector_form.png?fit=max&auto=format&n=nR16UlCzOGVbG_gR&q=85&s=528b6d38c7d6ed16e6c78ca29f62b260" alt="Add custom connector dialog with name and URL fields filled in" width="1970" height="1504" data-path="images/use-cases/marketo-mcp/claude-desktop/custom_connector_form.png" />
    </Frame>
  </Step>

  <Step id="connect-and-authenticate" title="Connect and authenticate">
    1. Find **allGood Marketo** in your Connectors list and click **Connect**

    <Frame caption="Connectors list showing the allGood Marketo connector with a Connect button">
      <img src="https://mintcdn.com/allgoodtechnologyinc/nR16UlCzOGVbG_gR/images/use-cases/marketo-mcp/claude-desktop/connector_list_connect.png?fit=max&auto=format&n=nR16UlCzOGVbG_gR&q=85&s=d078fa8c698b564323b88544eb157add" alt="Connectors list showing the allGood Marketo connector with a Connect button" width="1970" height="1504" data-path="images/use-cases/marketo-mcp/claude-desktop/connector_list_connect.png" />
    </Frame>

    2. A browser window opens and prompts you to log into your allGood account

    3. Review the requested permissions and click **Allow**

    4. Once authorized, the browser window closes and the connector status changes to **Connected**
  </Step>

  <Step id="enable-in-chat" title="Enable the connector in a chat">
    1. Start a new chat in Claude Desktop
    2. Click the tools icon below the message box
    3. Confirm **allGood Marketo** is toggled on for this conversation

    <Frame caption="Chat tools menu showing the allGood Marketo connector toggled on">
      <img src="https://mintcdn.com/allgoodtechnologyinc/nR16UlCzOGVbG_gR/images/use-cases/marketo-mcp/claude-desktop/chat_tools_toggle.png?fit=max&auto=format&n=nR16UlCzOGVbG_gR&q=85&s=edcc1e0fbdeda7436786830bc6241fa2" alt="Chat tools menu showing the allGood Marketo connector toggled on" width="1710" height="1380" data-path="images/use-cases/marketo-mcp/claude-desktop/chat_tools_toggle.png" />
    </Frame>

    4. Test the connection by asking Claude something like:

    > "Using allGood Marketo, look up the program details for \[program name]."
  </Step>
</Steps>

If Claude returns Marketo data, the connection is working correctly.

## Optional: Allow allGood's API domain for image uploads

<Note>
  This step is only needed if you want to use the Marketo MCP's image upload capability (uploading assets to Design Studio). Everything else — looking up programs, emails, forms, and templates, cloning campaigns — works without it.
</Note>

Claude restricts which external domains a connector can reach for capabilities like file/image handling. To let Claude upload images to Marketo's Design Studio through the allGood connector, add allGood's API domain to the allowlist:

1. In **Settings**, go to the **Capabilities** tab
2. Find the **Domain allowlist** (sometimes listed under network or connector permissions)
3. Click **Add domain** and enter `api.allgoodhq.app`
4. Save your changes

## Troubleshooting

<AccordionGroup>
  <Accordion title="The Connect button does nothing / the OAuth window doesn't open">
    Check that your browser isn't blocking pop-ups, then retry.
  </Accordion>

  <Accordion title="The connector shows Disconnected">
    Click **Connect** again and re-authenticate — your allGood session may have expired.
  </Accordion>

  <Accordion title="Claude says it doesn't have access to Marketo tools">
    Make sure the connector is toggled on for the current chat (see Step 4) — it's enabled per-conversation, not globally.
  </Accordion>

  <Accordion title="Add custom connector is missing from Settings">
    Custom connectors require a Claude plan that supports them (Pro, Max, Team, or Enterprise) and may need to be enabled by your workspace admin.
  </Accordion>

  <Accordion title="Image uploads to Design Studio fail">
    Check **Settings → Capabilities → Domain allowlist** and confirm `api.allgoodhq.app` is listed. If your workspace restricts outbound domains, Claude blocks the image upload until the domain is added — this doesn't affect any other Marketo MCP functionality.
  </Accordion>
</AccordionGroup>