Troubleshoot code quality workflows

This page covers common issues you might encounter when building code quality workflows with E2B sandboxes and MCP servers, along with their solutions.

If you're experiencing problems not covered here, check the E2B documentation.

MCP tools not available

Issue: Claude reports I don't have any MCP tools available.

Solution:

1. Verify you're using the authorization header:

   plaintextCopy

   --header "Authorization: Bearer ${mcpToken}"
   

2. Check you're waiting for MCP initialization.

   typescriptCopy

   // typescript
   await new Promise((resolve) => setTimeout(resolve, 1000));
   

   pythonCopy

   # python
   await asyncio.sleep(1)
   

3. Ensure credentials are in both envs and mcp configuration:

   typescriptCopy

   // typescript
   const sbx = await Sandbox.betaCreate({
     envs: {
       ANTHROPIC_API_KEY: process.env.ANTHROPIC_API_KEY!,
       GITHUB_TOKEN: process.env.GITHUB_TOKEN!,
       SONARQUBE_TOKEN: process.env.SONARQUBE_TOKEN!,
     },
     mcp: {
       githubOfficial: {
         githubPersonalAccessToken: process.env.GITHUB_TOKEN!,
       },
       sonarqube: {
         org: process.env.SONARQUBE_ORG!,
         token: process.env.SONARQUBE_TOKEN!,
         url: "https://sonarcloud.io",
       },
     },
   });
   

   pythonCopy

   # python
   sbx = await AsyncSandbox.beta_create(
       envs={
           "ANTHROPIC_API_KEY": os.getenv("ANTHROPIC_API_KEY"),
           "GITHUB_TOKEN": os.getenv("GITHUB_TOKEN"),
           "SONARQUBE_TOKEN": os.getenv("SONARQUBE_TOKEN"),
       },
       mcp={
           "githubOfficial": {
               "githubPersonalAccessToken": os.getenv("GITHUB_TOKEN"),
           },
           "sonarqube": {
               "org": os.getenv("SONARQUBE_ORG"),
               "token": os.getenv("SONARQUBE_TOKEN"),
               "url": "https://sonarcloud.io",
           },
       },
   )
   

4. Verify your API tokens are valid and have proper scopes.

GitHub tools work but SonarQube doesn't

Issue: GitHub MCP tools load but SonarQube tools don't appear.

Solution: SonarQube MCP server requires GitHub to be configured simultaneously. Always include both servers in your sandbox configuration, even if you're only testing one.

{{< tabs group="language" >}} {{< tab name="TypeScript" >}}

// Include both servers even if only using one
const sbx = await Sandbox.betaCreate({
  envs: {
    ANTHROPIC_API_KEY: process.env.ANTHROPIC_API_KEY!,
    GITHUB_TOKEN: process.env.GITHUB_TOKEN!,
    SONARQUBE_TOKEN: process.env.SONARQUBE_TOKEN!,
  },
  mcp: {
    githubOfficial: {
      githubPersonalAccessToken: process.env.GITHUB_TOKEN!,
    },
    sonarqube: {
      org: process.env.SONARQUBE_ORG!,
      token: process.env.SONARQUBE_TOKEN!,
      url: "https://sonarcloud.io",
    },
  },
});

{{< /tab >}} {{< tab name="Python" >}}

# Include both servers even if only using one
sbx = await AsyncSandbox.beta_create(
    envs={
        "ANTHROPIC_API_KEY": os.getenv("ANTHROPIC_API_KEY"),
        "GITHUB_TOKEN": os.getenv("GITHUB_TOKEN"),
        "SONARQUBE_TOKEN": os.getenv("SONARQUBE_TOKEN"),
    },
    mcp={
        "githubOfficial": {
            "githubPersonalAccessToken": os.getenv("GITHUB_TOKEN"),
        },
        "sonarqube": {
            "org": os.getenv("SONARQUBE_ORG"),
            "token": os.getenv("SONARQUBE_TOKEN"),
            "url": "https://sonarcloud.io",
        },
    },
)

{{< /tab >}} {{< /tabs >}}

Claude can't access private repositories

Issue: "I don't have access to that repository".

Solution:

1. Verify your GitHub token has repo scope (not just public_repo).

2. Test with a public repository first.

3. Ensure the repository owner and name are correct in your .env:

   {{< tabs group="language" >}} {{< tab name="TypeScript" >}}

   plaintextCopy

   GITHUB_OWNER=your_github_username
   GITHUB_REPO=your_repository_name
   

   {{< /tab >}} {{< tab name="Python" >}}

   plaintextCopy

   GITHUB_OWNER=your_github_username
   GITHUB_REPO=your_repository_name
   

   {{< /tab >}} {{< /tabs >}}

Workflow times out or runs too long

Issue: Workflow doesn't complete or Claude credits run out.

Solutions:

1. Use timeoutMs: 0 (TypeScript) or timeout_ms=0 (Python) for complex workflows to allow unlimited time:

   {{< tabs group="language" >}} {{< tab name="TypeScript" >}}

   typescriptCopy

   await sbx.commands.run(
     `echo '${prompt}' | claude -p --dangerously-skip-permissions`,
     {
       timeoutMs: 0, // No timeout
       onStdout: console.log,
       onStderr: console.log,
     },
   );
   

   {{< /tab >}} {{< tab name="Python" >}}

   pythonCopy

   await sbx.commands.run(
       f"echo '{prompt}' | claude -p --dangerously-skip-permissions",
       timeout_ms=0,  # No timeout
       on_stdout=print,
       on_stderr=print,
   )
   

   {{< /tab >}} {{< /tabs >}}

2. Break complex workflows into smaller, focused tasks.

3. Monitor your Anthropic API credit usage.

4. Add checkpoints in prompts: "After each step, show progress before continuing".

Sandbox cleanup errors

Issue: Sandboxes aren't being cleaned up properly, leading to resource exhaustion.

Solution: Always use proper error handling with cleanup in the finally block:

{{< tabs group="language" >}} {{< tab name="TypeScript" >}}

async function robustWorkflow() {
  let sbx: Sandbox | undefined;

  try {
    sbx = await Sandbox.betaCreate({
      // ... configuration
    });

    // ... workflow logic
  } catch (error) {
    console.error("Workflow failed:", error);
    process.exit(1);
  } finally {
    if (sbx) {
      console.log("Cleaning up sandbox...");
      await sbx.kill();
    }
  }
}

{{< /tab >}} {{< tab name="Python" >}}

async def robust_workflow():
    sbx = None

    try:
        sbx = await AsyncSandbox.beta_create(
            # ... configuration
        )

        # ... workflow logic

    except Exception as error:
        print(f"Workflow failed: {error}")
        sys.exit(1)
    finally:
        if sbx:
            print("Cleaning up sandbox...")
            await sbx.kill()

{{< /tab >}} {{< /tabs >}}

Environment variable not loading

Issue: Script fails with "undefined" or "None" for environment variables.

Solution:

{{< tabs group="language" >}} {{< tab name="TypeScript" >}}

1. Ensure dotenv is loaded at the top of your file:

   typescriptCopy

   import "dotenv/config";
   

2. Verify the .env file is in the same directory as your script.

3. Check variable names match exactly (case-sensitive):

   typescriptCopy

   // .env file
   GITHUB_TOKEN = ghp_xxxxx;
   
   // In code
   process.env.GITHUB_TOKEN; // Correct
   process.env.github_token; // Wrong - case doesn't match
   

   {{< /tab >}} {{< tab name="Python" >}}

   1. Ensure dotenv is loaded at the top of your file:

      pythonCopy

      from dotenv import load_dotenv
      load_dotenv()
      

   2. Verify the .env file is in the same directory as your script.

   3. Check variable names match exactly (case-sensitive):

      pythonCopy

      # .env file
      GITHUB_TOKEN=ghp_xxxxx
      
      # In code
      os.getenv("GITHUB_TOKEN")  # Correct
      os.getenv("github_token")  # Wrong - case doesn't match
      

   {{< /tab >}} {{< /tabs >}}

SonarQube returns empty results

Issue: SonarQube analysis returns no projects or issues.

Solution:

1. Verify your SonarCloud organization key is correct.
2. Ensure you have at least one project configured in SonarCloud.
3. Check that your SonarQube token has the necessary permissions.
4. Confirm your project has been analyzed at least once in SonarCloud.