Skip to content

Remote mcp gateway#143

Closed
vitocchi wants to merge 4 commits intogoogleworkspace:mainfrom
kushim-team:remote-mcp-gateway
Closed

Remote mcp gateway#143
vitocchi wants to merge 4 commits intogoogleworkspace:mainfrom
kushim-team:remote-mcp-gateway

Conversation

@vitocchi
Copy link

@vitocchi vitocchi commented Mar 5, 2026

Description

Please include a summary of the change and which issue is fixed. If adding a new feature or command, please include the output of running it with --dry-run to prove the JSON request body matches the Discovery Document schema.

Dry Run Output:

// Paste --dry-run output here if applicable

Checklist:

  • My code follows the AGENTS.md guidelines (no generated google-* crates).
  • I have run cargo fmt --all to format the code perfectly.
  • I have run cargo clippy -- -D warnings and resolved all warnings.
  • I have added tests that prove my fix is effective or that my feature works.
  • I have provided a Changeset file (e.g. via pnpx changeset) to document my changes.

vitocchi and others added 4 commits March 5, 2026 16:45
Describe that this repo is a fork of googleworkspace/cli maintained by
HODL1 (kushim-team), and document the branch strategy: main stays in
sync with upstream, custom carries all HODL1-specific changes.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
…velopment cycle; add design, requirements, and tasks documents for Remote MCP Gateway
@changeset-bot
Copy link

changeset-bot bot commented Mar 5, 2026

⚠️ No Changeset found

Latest commit: 35a1512

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@google-cla
Copy link

google-cla bot commented Mar 5, 2026

Thanks for your pull request! It looks like this may be your first contribution to a Google open source project. Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA).

View this failed invocation of the CLA check for more information.

For the most up to date status, view the checks section at the bottom of the pull request.

@gemini-code-assist
Copy link
Contributor

Summary of Changes

Hello, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request primarily focuses on documenting the repository's status as a fork and introducing the initial planning and design for a new "Remote MCP Gateway" feature. This gateway aims to enable secure and controlled access to Google Workspace APIs via Claude for Business/Enterprise, including robust authentication, authorization, and usage tracking mechanisms. The changes lay the groundwork for future development by outlining requirements, architectural decisions, and an implementation roadmap.

Highlights

  • Repository Fork Documentation: Updated AGENTS.md and README.md to clearly state that this repository is a HODL1 fork of googleworkspace/cli, including details on its branch strategy (main for upstream sync, custom for HODL1-specific changes).
  • AI-DLC Development Cycle Introduction: Introduced documentation in README.md for the AI-Driven Development Life Cycle (AI-DLC) adopted by the HODL1 fork, outlining the use of specs directories for requirements, design, and tasks.
  • Remote MCP Gateway Planning: Added comprehensive planning documents (design.md, requirements.md, tasks.md) for a new "Remote MCP Gateway" feature, detailing its architecture, authentication, authorization, data storage, and implementation roadmap to enable secure Google Workspace API access via Claude.
Changelog
  • AGENTS.md
    • Added a note indicating the repository is a fork maintained by HODL1 (kushim-team) and not an official Google product.
    • Introduced a "Fork Branch Strategy" section detailing main and custom branches and how to sync with upstream.
  • CLAUDE.md
    • Added a new file referencing AGENTS.md.
  • README.md
    • Updated the main title to "gws (HODL1 Fork)".
    • Added the same fork note and branch strategy as AGENTS.md.
    • Added a new section "AI-DLC 開発サイクル" (AI-DLC Development Cycle) in Japanese, explaining the development process and specs directory structure.
  • specs/remote-mcp-gateway/design.md
    • Added a new design document in Japanese for the "Remote MCP Gateway", outlining architecture, decisions, authentication flow, permission control, data storage, and usage statistics.
  • specs/remote-mcp-gateway/requirements.md
    • Added a new requirements document in Japanese for the "Remote MCP Gateway", detailing background, users, functional requirements (organizational connector distribution, Google account authentication, whitelist-based permission control, usage statistics), and non-functional requirements.
  • specs/remote-mcp-gateway/tasks.md
    • Added a new tasks document in Japanese for the "Remote MCP Gateway", outlining an implementation roadmap across 7 phases (Streamable HTTP, OAuth token management, Cloud Run deployment, organizational connector registration, permission control, tools/list filter, usage statistics).
Ignored Files
  • Ignored by pattern: .github/workflows/** (1)
    • .github/workflows/claude.yml
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

@vitocchi
Copy link
Author

vitocchi commented Mar 5, 2026

@claude tasks.md の タスク1 を実行して

@jpoehnelt jpoehnelt closed this Mar 5, 2026
Copy link
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

このプルリクエストは、フォークに関するドキュメントと新機能「Remote MCP Gateway」の仕様を追加するものです。CLAUDE.mdというファイルが追加されていますが、これはAGENTS.mdのコピーであり、誤って追加された可能性があります。また、AGENTS.mdREADME.mdでフォークのブランチ戦略に関する情報が重複しています。詳細は各コメントをご確認ください。

Note: Security Review has been skipped due to the limited scope of the PR.

@@ -0,0 +1 @@
AGENTS.md No newline at end of file
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

このファイルは誤って追加されたようです。ファイル名はCLAUDE.mdですが、内容はAGENTS.mdのコピーになっています。もしこのファイルが不要であれば、混乱を避けるために削除することを検討してください。

Comment on lines +7 to +30
> [!NOTE]
> This is a fork of [googleworkspace/cli](https://github.com/googleworkspace/cli) maintained by **HODL1** (kushim-team).
> This is **not** an officially supported Google product.

### Fork Branch Strategy

This repository is a fork of [googleworkspace/cli](https://github.com/googleworkspace/cli) with the following branch strategy:

| Branch | Purpose |
|--------|---------|
| `main` | Kept in sync with upstream `googleworkspace/cli` main. No custom changes. |
| `custom` | All HODL1-specific changes are developed here. |

#### Syncing with upstream

```bash
git fetch upstream
git checkout main
git merge upstream/main
git checkout custom
git merge main
```

Upstream updates are merged (not rebased) into `custom` to preserve a clean, shared-friendly history.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

フォークのブランチ戦略とアップストリームとの同期に関するこの情報は、README.mdにも存在します。情報の重複を避け、メンテナンスを容易にするために、この情報を一箇所(例えば開発者向けガイドであるこのAGENTS.md)に集約し、もう一方のファイルからはリンクするようにしてはいかがでしょうか。

@vitocchi vitocchi deleted the remote-mcp-gateway branch March 5, 2026 09:00
@vitocchi vitocchi restored the remote-mcp-gateway branch March 5, 2026 09:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants