Acessando o GitHub

Você pode montar um repositório do GitHub no contêiner da sua sessão e conectar-se ao GitHub MCP para criar pull requests.

Os repositórios do GitHub são armazenados em cache, portanto sessões futuras que usam o mesmo repositório iniciam mais rapidamente.

Todas as requisições da API de Managed Agents requerem o cabeçalho beta managed-agents-2026-04-01. O SDK define o cabeçalho beta automaticamente.

GitHub MCP e Recursos de Sessão

Primeiro, crie um agente que declare o servidor GitHub MCP. A definição do agente contém a URL do servidor, mas nenhum token de autenticação:

agent_id=$(curl -fsS https://api.anthropic.com/v1/agents \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01" \
  -H "content-type: application/json" \
  --data @- <<JSON | jq -r '.id'
{
  "name": "Code Reviewer",
  "model": "claude-sonnet-4-6",
  "system": "You are a code review assistant with access to GitHub.",
  "mcp_servers": [
    {
      "type": "url",
      "name": "github",
      "url": "https://api.githubcopilot.com/mcp/"
    }
  ],
  "tools": [
    {"type": "agent_toolset_20260401"},
    {
      "type": "mcp_toolset",
      "mcp_server_name": "github"
    }
  ]
}
JSON
)

Em seguida, crie uma sessão que monte o repositório do GitHub:

O resources[].authorization_token autentica a operação de clone do repositório e não é exibido nas respostas da API.

Permissões do token

Ao fornecer um token do GitHub, use as permissões mínimas necessárias:

Ação	Escopos necessários
Clonar repositórios privados	`repo`
Criar PRs	`repo`
Ler issues	`repo` (privado) ou `public_repo`
Criar issues	`repo` (privado) ou `public_repo`

Use tokens de acesso pessoal de granularidade fina com as permissões mínimas necessárias. Evite usar tokens com acesso amplo à sua conta do GitHub.

Múltiplos repositórios

Monte múltiplos repositórios adicionando entradas ao array resources:

Gerenciando repositórios em uma sessão em execução

Após a criação de uma sessão, você pode listar seus recursos de repositório e rotacionar seus tokens de autorização. Cada recurso possui um id retornado no momento da criação da sessão (ou via resources.list) que você usa para atualizações. Os repositórios ficam anexados durante o tempo de vida da sessão; para alterar quais repositórios estão montados, crie uma nova sessão.

Criando pull requests

Com o servidor GitHub MCP, o agente pode criar branches, fazer commit de alterações e enviá-las:

session_id=$(curl -fsS https://api.anthropic.com/v1/sessions \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01" \
  -H "content-type: application/json" \
  --data @- <<JSON | jq -r '.id'
{
  "agent": "$agent_id",
  "environment_id": "$environment_id",
  "resources": [
    {
      "type": "github_repository",
      "url": "https://github.com/org/repo",
      "mount_path": "/workspace/repo",
      "authorization_token": "ghp_your_github_token"
    }
  ]
}
JSON
)

resources='[
  {
    "type": "github_repository",
    "url": "https://github.com/org/frontend",
    "mount_path": "/workspace/frontend",
    "authorization_token": "ghp_your_github_token"
  },
  {
    "type": "github_repository",
    "url": "https://github.com/org/backend",
    "mount_path": "/workspace/backend",
    "authorization_token": "ghp_your_github_token"
  }
]'

# List resources on the session
repo_resource_id=$(curl -fsS "https://api.anthropic.com/v1/sessions/$session_id/resources" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01" \
  -H "content-type: application/json" | jq -r '.data[0].id')
echo "$repo_resource_id"  # "sesrsc_01ABC..."

# Rotate the authorization token
curl -fsS "https://api.anthropic.com/v1/sessions/$session_id/resources/$repo_resource_id" \
# ...
  -o /dev/null \
  --data @- <<JSON
{
  "authorization_token": "ghp_your_new_github_token"
}
JSON

curl -fsS "https://api.anthropic.com/v1/sessions/$session_id/events" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01" \
  -H "content-type: application/json" \
  -o /dev/null \
  --data @- <<JSON
{
  "events": [
    {
      "type": "user.message",
      "content": [
        {
          "type": "text",
          "text": "Fix the type error in src/utils.ts, commit it to a new branch, and push it."
        }
      ]
    }
  ]
}
JSON