Adam Ladachowski
114 lines
2.6 KiB
Markdown
114 lines
2.6 KiB
Markdown
# GitHub Login with Claude Browse
|
|
|
|
Documentation for logging into GitHub using the claude-browse MCP plugin.
|
|
|
|
## Overview
|
|
|
|
GitHub uses HttpOnly cookies for session management, which cannot be accessed via JavaScript. This means the standard cookie extraction approach doesn't work. Instead, use the **interactive login** method.
|
|
|
|
## Interactive Login Flow
|
|
|
|
### 1. Start browser and navigate to login
|
|
|
|
```
|
|
mcp__plugin_browse_browse__goto: https://github.com/login
|
|
```
|
|
|
|
### 2. Enter credentials
|
|
|
|
```
|
|
mcp__plugin_browse_browse__type:
|
|
selector: input[name="login"]
|
|
text: <username>
|
|
|
|
mcp__plugin_browse_browse__type:
|
|
selector: input[name="password"]
|
|
text: <password>
|
|
|
|
mcp__plugin_browse_browse__click:
|
|
selector: input[name="commit"]
|
|
```
|
|
|
|
### 3. Handle 2FA
|
|
|
|
GitHub may present SMS or authenticator-based 2FA.
|
|
|
|
**For SMS:**
|
|
```
|
|
mcp__plugin_browse_browse__click:
|
|
selector: button:has-text("Send SMS")
|
|
```
|
|
|
|
Wait for user to provide code, then:
|
|
```
|
|
mcp__plugin_browse_browse__type:
|
|
selector: input[name="sms_otp"]
|
|
text: <6-digit-code>
|
|
```
|
|
|
|
The form may auto-submit. If not:
|
|
```
|
|
mcp__plugin_browse_browse__click:
|
|
selector: button[type="submit"]
|
|
```
|
|
|
|
**Note:** The `input[name="otp"]` selector doesn't work - use `input[name="sms_otp"]` instead.
|
|
|
|
### 4. Save session for reuse
|
|
|
|
```
|
|
mcp__plugin_browse_browse__session_save:
|
|
path: /path/to/github-session.json
|
|
```
|
|
|
|
### 5. Restore session in future
|
|
|
|
```
|
|
mcp__plugin_browse_browse__session_restore:
|
|
path: /path/to/github-session.json
|
|
```
|
|
|
|
## Selector Reference
|
|
|
|
| Element | Selector |
|
|
|---------|----------|
|
|
| Username field | `input[name="login"]` |
|
|
| Password field | `input[name="password"]` |
|
|
| Sign in button | `input[name="commit"]` |
|
|
| SMS OTP field | `input[name="sms_otp"]` |
|
|
| Send SMS button | `button:has-text("Send SMS")` |
|
|
|
|
## Troubleshooting
|
|
|
|
### HttpOnly Cookies
|
|
|
|
GitHub's session cookies (`user_session`, `__Host-user_session_same_site`) are HttpOnly and cannot be read via `document.cookie`. The interactive login approach is required.
|
|
|
|
### Selector Timeouts
|
|
|
|
If `button:has-text("...")` times out, query all buttons first:
|
|
```
|
|
mcp__plugin_browse_browse__query:
|
|
selector: button
|
|
```
|
|
|
|
Then use a more specific selector based on the returned attributes.
|
|
|
|
### Auto-submit Forms
|
|
|
|
GitHub's 2FA form may auto-submit after entering the code. Check if the page redirected before trying to click submit.
|
|
|
|
## Session Storage Location
|
|
|
|
Recommended path: `~/.claude/github-session.json`
|
|
|
|
The session file contains:
|
|
- Current URL
|
|
- All cookies (including HttpOnly ones captured by Playwright)
|
|
- localStorage
|
|
- sessionStorage
|
|
|
|
## Cookie Count
|
|
|
|
A successful GitHub login typically results in ~14 cookies being stored.
|