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

# Troubleshooting

export const TroubleshootSolution = ({children}) => <>
    <hr className="my-3 w-full" />
    <details className="mt-3">
      <summary className="cursor-pointer font-semibold text-base mb-1">
        Solution
      </summary>
      <div className="mt-2 ml-4" data-component-part="step-content">
        {children}
      </div>
    </details>
  </>;

export const TroubleshootCause = ({children}) => <details className="mt-3 mb-2">
    <summary className="cursor-pointer font-semibold text-base mb-1">
      Cause
    </summary>
    <div className="mt-2 ml-4" data-component-part="step-content">
      {children}
    </div>
  </details>;

export const TroubleshootTitle = ({children}) => <>
    <p className="m-0 font-semibold text-xl leading-tight mb-2" role="heading" aria-level={3}>
      {children}
    </p>
    <hr className="my-3 w-full" />
  </>;

export const Troubleshoot = ({children}) => <div className="callout my-4 px-5 py-4 overflow-hidden rounded-2xl flex gap-3 border troubleshoot-admonition dark:troubleshoot-admonition" data-callout-type="troubleshoot">
    <div className="mt-0.5 w-4">
      <svg width="14" height="14" viewBox="0 0 640 640" fill="currentColor" className="w-4 h-4" aria-label="Troubleshoot">
        <path d="M541.4 162.6C549 155 561.7 156.9 565.5 166.9C572.3 184.6 576 203.9 576 224C576 312.4 504.4 384 416 384C398.5 384 381.6 381.2 365.8 376L178.9 562.9C150.8 591 105.2 591 77.1 562.9C49 534.8 49 489.2 77.1 461.1L264 274.2C258.8 258.4 256 241.6 256 224C256 135.6 327.6 64 416 64C436.1 64 455.4 67.7 473.1 74.5C483.1 78.3 484.9 91 477.4 98.6L388.7 187.3C385.7 190.3 384 194.4 384 198.6L384 240C384 248.8 391.2 256 400 256L441.4 256C445.6 256 449.7 254.3 452.7 251.3L541.4 162.6z" />
      </svg>
    </div>
    <div className="prose min-w-0 w-full">{children}</div>
  </div>;

<Troubleshoot>
  <TroubleshootTitle>
    ### Anaconda MCP Server won't start
  </TroubleshootTitle>

  <TroubleshootCause>
    Anaconda MCP Server might fail to start if the configuration file is missing or contains invalid TOML.
  </TroubleshootCause>

  <TroubleshootSolution>
    Check that the configuration file exists and contains valid TOML:

    ```sh theme={null}
    ls src/anaconda_mcp/mcp_compose.toml
    ```

    Run with verbose logging to see detailed errors:

    ```sh theme={null}
    anaconda-mcp -v serve
    ```

    Check whether the port is already in use:

    ```sh theme={null}
    lsof -i :2391
    ```
  </TroubleshootSolution>
</Troubleshoot>

<Troubleshoot>
  <TroubleshootTitle>
    ### Port already in use (port collision)
  </TroubleshootTitle>

  <TroubleshootCause>
    Port collision occurs when using streamable HTTP transport and another process is already listening on the port Anaconda MCP Server is trying to bind to (default: `2391`). The server fails to start with an error like `Address already in use` or `OSError: [Errno 48]`.
  </TroubleshootCause>

  <TroubleshootSolution>
    Find out what is using the port:

    <Tabs>
      <Tab title="Windows">
        ```sh theme={null}
        netstat -ano | findstr :2391
        ```
      </Tab>

      <Tab title="macOS/Linux">
        ```sh theme={null}
        lsof -i :2391
        ```
      </Tab>
    </Tabs>

    You can either stop the conflicting process, or start Anaconda MCP Server on a different port:

    ```sh theme={null}
    anaconda-mcp serve --port 8888
    ```

    If you changed the port, update your Claude Desktop configuration to match the new port:

    ```sh theme={null}
    anaconda-mcp claude-desktop setup-config --transport streamable-http --port 8888 --force
    ```

    To avoid having to specify the new port every time you start the server, set a custom default port in `mcp_compose.toml.template`:

    ```toml theme={null}
    [composer]
    port = 8888
    ```
  </TroubleshootSolution>
</Troubleshoot>

<Troubleshoot>
  <TroubleshootTitle>
    ### Anaconda MCP tools are not appearing in Claude Desktop
  </TroubleshootTitle>

  <TroubleshootCause>
    This can occur if Claude Desktop was not fully restarted after running the setup command, the configuration was not written correctly, or the Python path in the configuration points to the wrong conda environment.
  </TroubleshootCause>

  <TroubleshootSolution>
    1. Make sure you fully restarted Claude Desktop by quitting and reopening it completely, rather than just closing the window.

    2. If that didn't resolve the issue, verify the configuration was written correctly:

       ```sh theme={null}
       anaconda-mcp claude-desktop show
       ```

    3. Finally, check that the Python path in the configuration points to the correct conda environment.

           <Accordion title="Finding your Python interpreter path">
             To find your Python interpreter path:

             <Tabs>
               <Tab title="Windows">
                 Open Anaconda Prompt and run `where python` in the environment where you installed the `anaconda-mcp` package.
               </Tab>

               <Tab title="macOS/Linux">
                 Open Terminal and run `which python` in the environment where you installed the `anaconda-mcp` package.
               </Tab>
             </Tabs>
           </Accordion>
  </TroubleshootSolution>
</Troubleshoot>