Samebase MCP server
Commit Nov 11, 2026Connects AI clients to repository-backed web applications managed through GitHub, Convex, and Cloudflare.
Also known as samebase/plugin, plugin
- Stars
- 1
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.3.6
- Last commit
- Nov 11, 2026
- License
- Apache-2.0
What is Samebase MCP?
Samebase connects AI clients to repository-backed web applications managed through GitHub, Convex, and Cloudflare.
Summary generated from the project's README
About Samebase MCP server
Samebase provides an MCP server that links AI clients like Claude Code, ChatGPT, and Codex to web applications managed via GitHub, Convex, and Cloudflare. This connection allows developers to interact with repository-backed apps directly through their preferred AI interface. The server includes a specific skill designed to help the client decide when to trigger Samebase actions or when to request permission before changing a provider.
Users set up the server through specific marketplace commands depending on their client, such as using the /plugin command in Claude Code or the plugin catalog in ChatGPT. Authorization happens through an OAuth flow, and the browser-handoff action provides a one-time URL to access the dashboard. To verify a successful connection, a user can simply ask the agent to list their apps. The system is designed to work locally within the client environment once the marketplace installation and authorization steps are completed.
What you can do with it
- 1List managed applicationsAsk the AI agent to retrieve a list of all your existing Samebase apps.
- 2Access the application dashboardRequest the agent to open the dashboard using a secure, one-time URL.
- 3Manage plugin installationsInstruct the client to add or update the Samebase plugin through its marketplace.
Written from the project's README. Every use case is checked against a quote from it.
How to install Samebase MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Samebase MCP in Claude Code
$ claude mcp add --transport http plugin https://samebase.com/mcpInstall Samebase MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"plugin": {
"url": "https://samebase.com/mcp"
}
}
}Install Samebase MCP in VS Code
.vscode/mcp.json
{
"servers": {
"plugin": {
"type": "http",
"url": "https://samebase.com/mcp"
}
}
}Install Samebase MCP in VS Code CLI
$ code --add-mcp '{"name":"plugin","type":"http","url":"https://samebase.com/mcp"}'Install Samebase MCP in Codex
$ codex mcp add plugin --url https://samebase.com/mcpInstall Samebase MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.plugin] url = "https://samebase.com/mcp"
Install Samebase MCP in Gemini CLI
$ gemini mcp add -s user --transport http plugin https://samebase.com/mcpInstall Samebase MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"plugin": {
"url": "https://samebase.com/mcp",
"type": "http"
}
}
}Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablesamebase/plugin is public and reachablegithub.com/samebase/plugin ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-11github.com/samebase/plugin ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubSamebase plugin
Samebase connects ChatGPT, Codex, and Claude Code to repository-backed apps managed by Samebase. The plugin includes the Samebase MCP server and one skill that tells the client when to use Samebase and when to ask before a provider change.
This repository is generated. Do not edit it directly. Use GitHub Issues to request a change or report a problem.
Authorize Samebase
The plugin installs one MCP server named samebase. Authorize it when the client asks for access.
Do not add https://samebase.com/mcp as a second manual server.
open @samebase works only after Samebase is authorized. The agent opens the dashboard only with a
one-time URL returned by the Samebase browser-handoff action. The public Samebase site is not an
authorization or dashboard fallback.
If a requested Samebase action is absent, including when no Samebase actions appear, use the recovery controls for the current client. A missing action does not prove that authorization failed. Start authorization only when a callable connection or action reports an authorization or scope error. Do not open the public Samebase site as a fallback.
Start a new chat or task after installation or an update. To confirm the connection, ask:
Use Samebase to list my apps.
Install with ChatGPT or Codex
Install Samebase from Plugins when it appears in your ChatGPT Work or Codex catalog.
For direct Codex installation, add this repository as a marketplace:
codex plugin marketplace add samebase/plugin
codex plugin add samebase@samebase
Update a direct installation with:
codex plugin marketplace upgrade samebase
codex plugin add samebase@samebase
If a requested action is absent, use Codex Plugins if the CLI is unavailable. Refresh the
marketplace. Read the latest available version and the direct entry's installed state and version.
If the user states in a new task that this version was already repaired, report that the plugin did
not register and stop. Otherwise, install or enable samebase@samebase if it is absent or disabled,
update it if it is older, or reinstall only that entry if the versions match. Complete the OAuth
flow started by installation. Before restart, tell the user to state the repaired version in the new
task.
Install with Claude Code
Add the marketplace and install the plugin:
/plugin marketplace add samebase/plugin
/plugin install samebase@samebase
/reload-plugins
Update it with:
/plugin marketplace update samebase
/plugin update samebase@samebase
/reload-plugins
Use /mcp to authorize Samebase when Claude Code asks for access.
If a requested action is absent, inspect the local entry with /plugin, then run the marketplace
update, plugin update, and reload commands above. Use /mcp only when the connection reports an
authorization error. If actions remain absent after reload, report that the MCP connection did not
register and stop. Do not use Codex plugin state or controls.
Support and security
Use GitHub Issues for support and non-sensitive bugs. Follow SECURITY.md for private vulnerability reports.
This repository uses the Apache License 2.0.
Samebase MCP questions
How do I add Samebase MCP to Claude Code?
Run claude mcp add --transport http plugin https://samebase.com/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Samebase MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How do I install Samebase with Claude Code?
Add the marketplace, install the plugin using the specific plugin commands, and then reload the plugins.
What should I do if Samebase actions are missing in my client?
Do not assume authorization failed; instead, use the recovery controls for your current client or inspect the local entry.