Kết nối InnerSheet với AI client của bạn
Một server, mọi client. App desktop và CLI khởi chạy InnerSheet local qua stdio; web chat tới được nó qua HTTPS sau khi bạn triển khai ở chế độ remote.
InnerSheet nói chuẩn MCP qua stdio, nên client nào có thể chạy một process local cũng dùng được. Nếu client của bạn chạy được một chương trình, nó sẽ chạy được — khác biệt duy nhất giữa các client là file cấu hình nằm ở đâu. Thay /path/to/innersheet trong các đoạn mẫu dưới đây bằng thư mục thật của bạn.
Tương thích nhanh
| Client | File cấu hình | Trạng thái | Ghi chú |
|---|---|---|---|
| Claude Desktop | claude_desktop_config.json | Hỗ trợ | Khối mcpServers; khởi động lại sau khi sửa |
| Claude Code | claude mcp add / .mcp.json | Hỗ trợ | Một lệnh; file project có thể commit |
| Cursor | .cursor/mcp.json | Hỗ trợ | JSON giống hệt Claude Desktop |
| Codex (OpenAI CLI) | ~/.codex/config.toml | Hỗ trợ | Bảng [mcp_servers.innersheet] (snake_case) |
| VS Code + GitHub Copilot | .mcp.json / .vscode/mcp.json | Hỗ trợ | Cần bật Agent mode; xem cảnh báo về tên key bên dưới |
| Gemini CLI | ~/.gemini/settings.json | Hỗ trợ | gemini mcp add -s user |
| Windsurf · Cline · Zed · JetBrains | Cài đặt MCP của client | Chuẩn MCP | Cùng lệnh stdio + biến môi trường; xem tài liệu MCP của từng client |
| ChatGPT (web) | Plugins / Developer mode | Chỉ remote | Cần endpoint HTTPS công khai — triển khai ở chế độ HTTP |
| Claude.ai (web) | Settings → Connectors | Chỉ remote | Thêm custom connector bằng URL của server |
| Muse | Luồng custom connector | Chỉ remote | Không có ô dán URL; kết nối server đã triển khai làm custom connector |
| Gemini (web app) | Settings → Connected Apps | Chỉ ở Mỹ | Custom app cần tài khoản cá nhân, trên 18 tuổi, ở Mỹ, tiếng Anh |
| Loại client | Chạy ở đâu | Kết nối InnerSheet thế nào |
|---|---|---|
| App desktop và CLI | Máy của bạn | Khởi chạy InnerSheet như một process local (stdio) |
| Web chat | Cloud | Chỉ tới được server ở một địa chỉ HTTPS công khai |
Đó là lý do InnerSheet v2 có thêm chế độ Streamable HTTP bên cạnh chế độ local — cùng một code, khác transport, được bảo vệ bằng API key.
Đã dùng trình cài đặt? Mục này đã có sẵn (dùng uv run, xem trình cài đặt ghi gì) — chỉ cần khởi động lại Claude Desktop.
Thêm đoạn này vào claude_desktop_config.json (Claude Desktop → Settings → Developer → Edit Config), rồi thoát hẳn và khởi động lại Claude Desktop.
{
"mcpServers": {
"innersheet": {
"command": "/path/to/innersheet/.venv/bin/python",
"args": ["/path/to/innersheet/server.py"],
"env": {
"GOOGLE_OAUTH_CLIENT_SECRETS": "/path/to/client_secret.json"
}
}
}
}Trên macOS và Linux, đường dẫn Python là .venv/bin/python. Trên Windows là C:\innersheet\.venv\Scripts\python.exe — lưu ý dấu gạch chéo ngược phải nhân đôi trong JSON. Nếu bạn cài bằng uv, có thể dùng uv làm command với đối số ["run", "/path/to/innersheet/server.py"].
Một lệnh duy nhất từ terminal. Xuất biến môi trường trước, hoặc truyền bằng -e:
claude mcp add innersheet -e GOOGLE_OAUTH_CLIENT_SECRETS=/path/to/client_secret.json -- /path/to/innersheet/.venv/bin/python /path/to/innersheet/server.py- Kiểm tra bằng
claude mcp list. - Với project cả nhóm cùng dùng, hãy commit file
.mcp.jsonvới cùng khốimcpServersnhư Claude Desktop — mỗi người chỉ cầnclient_secret.jsoncủa riêng mình. - InnerSheet còn có gói plugin Claude Code (skill + hooks); xem trang Công cụ để biết plugin thêm gì.
Tạo file .cursor/mcp.json trong project (hoặc Cursor → Settings → MCP → Add):
{
"mcpServers": {
"innersheet": {
"command": "/path/to/innersheet/.venv/bin/python",
"args": ["/path/to/innersheet/server.py"],
"env": {
"GOOGLE_OAUTH_CLIENT_SECRETS": "/path/to/client_secret.json"
}
}
}
}Cursor còn tự nhập hook Claude Code từ ~/.claude/settings.json khi Third-Party Imports đang bật (mặc định là bật), nên các hook an toàn của InnerSheet chạy trong Cursor mà không cần cấu hình thêm.
Thêm đoạn này vào ~/.codex/config.toml (hoặc chạy codex mcp add). Chú ý tên bảng — phải là snake_case mcp_servers, không phải mcpServers; gõ sai tên là cả đoạn sẽ bị bỏ qua trong im lặng.
[mcp_servers.innersheet]
command = "/path/to/innersheet/.venv/bin/python"
args = ["/path/to/innersheet/server.py"]
[mcp_servers.innersheet.env]
GOOGLE_OAUTH_CLIENT_SECRETS = "/path/to/client_secret.json"Kiểm tra bằng codex mcp list, rồi gõ /mcp trong Codex để thấy server và các công cụ của nó. Một project có thể đặt cùng bảng này trong .codex/config.toml, mà Codex chỉ đọc với project đã được tin cậy.
Nên dùng: file portable .mcp.json ở gốc workspace, dùng key cấp cao nhất là mcpServers. File cũ .vscode/mcp.json dùng servers thay thế — chép mục cấu hình giữa hai file mà không đổi tên key là lỗi im lặng thường gặp nhất.
{
"mcpServers": {
"innersheet": {
"command": "/path/to/innersheet/.venv/bin/python",
"args": ["/path/to/innersheet/server.py"],
"env": {
"GOOGLE_OAUTH_CLIENT_SECRETS": "/path/to/client_secret.json"
}
}
}
}Sau đó chuyển Copilot Chat sang Agent mode — công cụ MCP không chạy ở Ask mode. Copilot CLI đọc cùng mục cấu hình đó từ ~/.copilot/mcp-config.json. Nếu Copilot của bạn thuộc một tổ chức, quản trị viên phải bật chính sách "MCP servers in Copilot", và mặc định nó đang tắt.
Một lệnh (-s user để dùng được ở mọi nơi), hoặc sửa ~/.gemini/settings.json bằng tay:
gemini mcp add -s user innersheet -e GOOGLE_OAUTH_CLIENT_SECRETS=/path/to/client_secret.json /path/to/innersheet/.venv/bin/python /path/to/innersheet/server.pyKhởi động lại gemini rồi chạy /mcp — InnerSheet phải hiện CONNECTED kèm danh sách công cụ bên dưới. Lưu ý quyền truy cập Gemini CLI cho tài khoản miễn phí và cá nhân trả phí đã chuyển sang Antigravity CLI từ tháng 6/2026, nên hãy kiểm tra gói của bạn dùng CLI nào trước khi thiết lập.
Web chat: chế độ remote
ChatGPT, Claude.ai, web app Gemini và Muse đều chạy trên cloud, nên không cái nào khởi chạy được chương trình trên máy tính của bạn. Để dùng InnerSheet ở đó:
- Triển khai nó như một server remote qua Streamable HTTP — FastMCP hỗ trợ transport này sẵn, nên cùng một code phục vụ cả hai chế độ.
- Bảo vệ nó bằng API key.
- Thêm URL công khai vào đúng chỗ chat đó yêu cầu:
| Web chat | Nơi thêm URL | Điều kiện |
|---|---|---|
| ChatGPT | Plugins / Developer mode | Gói Pro trở lên |
| Claude.ai | Settings → Connectors → Add custom connector | Gói Free được một custom connector |
| Web app Gemini | Settings → Connected Apps → Custom apps | Tài khoản cá nhân, trên 18 tuổi, ở Mỹ, tiếng Anh, bật Keep Activity |
| Muse | Luồng custom connector | — |
Đừng bao giờ public mà không có xác thực. Một MCP server Sheets remote đang cầm credential Google của bạn: ai có URL cũng đọc và ghi được sheet của bạn. Trang bảo mật trình bày kỹ về triển khai remote.
Nhắc tin cậy và giới hạn số công cụ
Mọi client đều hỏi bạn phê duyệt MCP server mới ít nhất một lần:
- Claude Code và Cursor hiện nhắc tin cậy với config project.
- Codex yêu cầu bạn tin cậy hook mới bằng
/hooks. - Copilot có thể hỏi từng lần gọi công cụ ở Agent mode.
Sự phiền phức đó là có chủ ý: MCP server chạy với quyền của bạn, nên client nào lặng lẽ tải mọi server nó tìm thấy sẽ là một lỗ hổng bảo mật. Hai mươi bốn công cụ của InnerSheet nằm dưới hẳn các giới hạn số công cụ mỗi request mà client áp đặt (ví dụ VS Code cho phép 128 công cụ mỗi request), nên bạn sẽ không chạm trần.
Công cụ không hiện sau khi thiết lập?
- Khởi động lại client trước — hầu hết client chỉ đọc cấu hình MCP lúc khởi động.
- Rồi kiểm tra đường dẫn command trong config — đường dẫn Python sai là nguyên nhân trong chín trên mười trường hợp.
Mọi lỗi khác kèm cách sửa có ở trang Xử lý lỗi.