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

# Troubleshooting

> Fixes for common Juno MCP connection issues.

export const RelatedPages = ({pages = []}) => {
  if (pages.length === 0) return null;
  return <>
      <br />
      <strong>Related articles</strong>
      <CardGroup cols={2}>
        {pages.map(page => <Card title={page.title} href={page.href} key={page.href} />)}
      </CardGroup>
    </>;
};

export const SupportContact = () => {
  return <Info title="Still need help?">
      Contact us at <a href="mailto:support@junojourney.com">support@junojourney.com</a> or use the support widget in Juno.
    </Info>;
};

<Info>
  Common issues connecting an assistant to the Juno MCP server, and how to fix them.
</Info>

## Not connected, or stuck in a sign-in loop

* Confirm your **workspace slug** is correct — it's your Juno subdomain (e.g. `acme` for `acme.junojourney.com`).
* Make sure you have access to that workspace, then re-run the sign-in.
* Check the server URL: `https://mcp-prod.the-juno.com/mcp?workspace=<your-workspace>`.

## "That isn't available", or a tool is missing

The capability isn't enabled for your account. Tools you aren't permitted to use don't appear to your assistant.

* Ask your Juno administrator to enable chat access for that capability.
* If an admin just enabled it, **reconnect** the Juno server so the new tools load.
* In the meantime, the same actions are available in the Juno web app.

## The assistant can't find the server

* Double-check the JSON is valid and placed under the config key your client expects (most use `mcpServers`).
* Confirm the transport is set to `"type": "http"`.

## Wrong or missing content

* Content is scoped to your permissions — you only see what your Juno role allows.
* Confirm you signed in to the intended workspace.

<SupportContact />

<RelatedPages
  pages={[
{ href: "/mcp/overview", title: "MCP overview" },
{ href: "/mcp/security", title: "Security & permissions" }
]}
/>