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

ClientFile cấu hìnhTrạng tháiGhi chú
Claude Desktopclaude_desktop_config.jsonHỗ trợKhối mcpServers; khởi động lại sau khi sửa
Claude Codeclaude mcp add / .mcp.jsonHỗ trợMột lệnh; file project có thể commit
Cursor.cursor/mcp.jsonHỗ trợJSON giống hệt Claude Desktop
Codex (OpenAI CLI)~/.codex/config.tomlHỗ trợBảng [mcp_servers.innersheet] (snake_case)
VS Code + GitHub Copilot.mcp.json / .vscode/mcp.jsonHỗ trợCần bật Agent mode; xem cảnh báo về tên key bên dưới
Gemini CLI~/.gemini/settings.jsonHỗ trợgemini mcp add -s user
Windsurf · Cline · Zed · JetBrainsCài đặt MCP của clientChuẩn MCPCù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 modeChỉ remoteCần endpoint HTTPS công khai — triển khai ở chế độ HTTP
Claude.ai (web)Settings → ConnectorsChỉ remoteThêm custom connector bằng URL của server
MuseLuồng custom connectorChỉ remoteKhông có ô dán URL; kết nối server đã triển khai làm custom connector
Gemini (web app)Settings → Connected AppsChỉ ở MỹCustom app cần tài khoản cá nhân, trên 18 tuổi, ở Mỹ, tiếng Anh
Loại clientChạy ở đâuKết nối InnerSheet thế nào
App desktop và CLIMáy của bạnKhởi chạy InnerSheet như một process local (stdio)
Web chatCloudChỉ 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.json với cùng khối mcpServers như Claude Desktop — mỗi người chỉ cần client_secret.json củ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.py

Khở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 ở đó:

  1. 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ế độ.
  2. Bảo vệ nó bằng API key.
  3. Thêm URL công khai vào đúng chỗ chat đó yêu cầu:
Web chatNơi thêm URLĐiều kiện
ChatGPTPlugins / Developer modeGói Pro trở lên
Claude.aiSettings → Connectors → Add custom connectorGói Free được một custom connector
Web app GeminiSettings → Connected Apps → Custom appsTài khoản cá nhân, trên 18 tuổi, ở Mỹ, tiếng Anh, bật Keep Activity
MuseLuồ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:

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?

  1. 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.
  2. 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.