Skip to content

Beringio docs

Connect your AI, see what it can do in your team’s hub and how your data stays safe.

What Beringio is

Beringio is a shared hub for a team where everyone works in their own AI — Claude, ChatGPT, Cursor or another. Through the hub everyone’s AI shares the same things: the team chat, calls, a board, the team’s context (decisions, conflicts between them, glossary) and hub apps.

Your AI connects to Beringio over MCP. It can check what the team already decided before you start, save new decisions, catch conflicts with earlier ones, and post to the chat or the board when you ask. You can also use every hub on the website.

Connect your AI

One server URL for every AI app. Sign-in is by OAuth: you sign in with your email and click “Allow”. Use the same email everywhere.

https://beringio.com/mcp

Claude

  1. Claude (website or desktop app) → Settings → Connectors → “Add” → “Add custom connector”.
  2. Name — Beringio, URL — above. Click “Add”, then “Connect”.
  3. Sign in with your email and click “Allow”. The connector then works in the Claude mobile app too.

ChatGPT

  1. ChatGPT website → Plugins → “Add” → “Add custom MCP server”.
  2. Name — Beringio, URL — above, authentication — OAuth. Tick “I understand” and click “Create”, then “Connect”.
  3. Sign in with your email and click “Allow”.
  4. ChatGPT app on Mac: Settings → Plugins → MCP → “Add” → “Add MCP server”, type — Streamable HTTP, URL — above, then “Authenticate”.

Claude Code

  1. In the terminal: claude mcp add --transport http beringio https://beringio.com/mcp
  2. In Claude Code, run /mcp and sign in with your email.

Codex CLI

  1. In the terminal: codex mcp add beringio --url https://beringio.com/mcp
  2. Codex opens the browser to sign in; if not, run codex mcp login beringio.

Cursor

Add Beringio to Cursor

Or add it by hand: Cursor → Settings → MCP → add a new server; it opens ~/.cursor/mcp.json. Add Beringio there:

{
  "mcpServers": {
    "beringio": {
      "url": "https://beringio.com/mcp"
    }
  }
}

Then click “Connect” next to beringio and sign in with your email in the browser.

VS Code

Add Beringio to VS Code

Or in the terminal: code --add-mcp '{"name":"beringio","type":"http","url":"https://beringio.com/mcp"}' — or Command Palette → “MCP: Add Server” → HTTP → the URL above. Start the server and sign in with your email when VS Code opens the browser. Needs GitHub Copilot.

Other AI apps that support remote MCP servers with OAuth (Gemini, Windsurf, Perplexity and others) connect with the same URL.

Example prompts

  • “What’s new in my team hub?”

    Your AI calls hub_updates and sums up new chat messages, decisions, open conflicts and apps in a few lines, with links to the hub.

  • “Save that we’re launching on March 3 as a team decision”

    Your AI calls save_decision. The hub checks it against earlier decisions; if it conflicts with one, your AI tells you which and suggests discussing it with the team.

  • “Open our hub”

    Your AI calls open_hub: the hub appears right in the chat with its chat, call, board, apps and context. In clients without widgets you get a link to the hub on the website.

  • “Add these three ideas to the board as sticky notes”

    Your AI calls add_board_stickies and puts three sticky notes on the hub’s shared board, where every member sees them.

  • “What does “north star metric” mean in our team?”

    Your AI calls get_glossary and answers with the definition your team agreed on, naming who wrote it.

  • “Call the team”

    Your AI calls start_call: the hub’s voice and video call opens in the chat, and teammates join by asking their own AI.

Tools

Your AI chooses tools on its own based on what you ask. “Reads” tools only read hub data. “Adds” tools create something new that other members may see. “Changes or deletes” tools edit or remove existing data or access — your AI should confirm these with you first.

Hubs & members

ToolWhat it doesData
get_startedIntroduction to Beringio, shown with an example from your own work.Reads
list_hubsThe hubs you’re a member of, with your role in each.Reads
hub_updatesWhat’s new since you last asked: chat messages, decisions, terms, conflicts and apps. Moves your own “seen” mark.Adds
open_hubShows the hub right in the chat as an interactive widget: chat, call, board, apps and context.Reads
open_hub_in_browserGives a link to the web version of the hub. Coding agents with a built-in browser (Claude Code, Cursor) also get a one-time sign-in link for it.Adds
create_hubCreates a new team hub; you become its owner.Adds
invite_linkGets the hub’s invite link for you to send to your team.Adds
find_public_hubsFinds public hubs — interest communities you can join without an invite.Reads
join_public_hubJoins a public hub.Adds
list_membersHub members: name, role, team role, the contacts they chose to share and when they joined.Reads
set_my_profileSets how the members of a hub see you: name, team role, contacts.Changes or deletes
update_hubChanges a hub’s name, description, visibility and rules (owner and admins).Changes or deletes
remove_memberRemoves a member from a hub, or leaves it yourself.Changes or deletes
set_member_roleMakes members admins or revokes admin rights (owner).Changes or deletes
transfer_ownershipHands the hub over to another member (owner).Changes or deletes
unban_memberLifts a ban so a person can join a public hub again.Changes or deletes
delete_hubDeletes a hub with everything in it (owner only).Changes or deletes
connect_projectGives a section for your repository’s AGENTS.md so any AI in the project uses the hub.Reads

Context: decisions, conflicts, glossary

ToolWhat it doesData
get_contextThe team’s decisions (latest or related to a topic), open conflicts and glossary.Reads
save_decisionSaves a decision you agreed on; the hub checks it against earlier decisions for conflicts.Adds
edit_decisionEdits your own decision: topic, summary or rationale.Changes or deletes
delete_decisionDeletes a decision (its author, the owner or admins).Changes or deletes
review_decisionAccepts or rejects a proposed decision.Changes or deletes
resolve_conflictCloses a conflict between decisions once the team agreed how to settle it.Changes or deletes
get_glossaryThe team glossary: terms and the definitions the team agreed on.Reads
define_termAdds a term to the glossary; replaces a different definition only after you confirm.Changes or deletes
context_historyEvery version of a decision or term: who saved it and when.Reads
restore_versionBrings back an earlier version of a decision or term.Changes or deletes
get_knowledgeThe knowledge map: tags, decisions, terms and the links between them.Reads
tag_contextCreates, renames, deletes and assigns context tags (owner and admins).Changes or deletes
link_contextLinks two decisions or terms in the knowledge map, or removes a link (owner and admins).Changes or deletes

Chat

ToolWhat it doesData
read_hub_chatReads the latest messages of the hub’s shared chat.Reads
read_chat_fileReads a file from the chat: an image, a PDF or a text file.Reads
post_to_hub_chatSends a message to the hub’s chat on your behalf.Adds
send_file_to_hub_chatSends a file to the hub’s chat on your behalf.Adds
edit_hub_chat_messageEdits your own chat message.Changes or deletes
delete_hub_chat_messageDeletes your message, or anyone’s if you’re the owner or an admin.Changes or deletes

Board

ToolWhat it doesData
read_boardViews the hub’s shared board: an image of it and a list of its objects.Reads
add_board_stickiesPuts sticky notes on the board, optionally inside a titled frame.Adds
edit_boardEdits the board: adds, moves, updates, arranges and deletes objects.Changes or deletes

Calls

ToolWhat it doesData
start_callOpens the hub’s voice and video call in the chat, or joins one in progress.Adds
call_statusWhether a call is in progress and who is in it.Reads

Apps

ToolWhat it doesData
app_guideHow to build a hub app: the contract your AI follows.Reads
list_appsThe hub’s apps: what they are and which hub data they read.Reads
get_appThe code of a hub app, to edit it (large apps come in parts).Reads
create_appPublishes a new app to the hub.Adds
update_appEdits an app; a new page makes a new version.Changes or deletes
delete_appDeletes an app from the hub (its author, the owner or admins).Changes or deletes

What other members see

  • Everything your AI adds to a hub — messages, files, decisions, terms, sticky notes, apps — is visible to all members of that hub and to the AI apps they connect, with your name as the author.
  • Your profile in a hub: your name, role, team role and the contacts you chose to add.
  • Your conversations with your AI stay between you and your AI provider: only what your AI sends to the hub is shared.
  • The full email you sign in with is never shown to AI apps or to other members of a public hub. In a private hub only the owner and admins see members’ emails; a member with no name set appears there under the part of their email before the @.
  • In a public hub anyone who joins sees its decisions, glossary, chat and members’ names and profiles.

Safety

  • Everything in a hub was written by other people. Beringio’s tools return it as data with its source, and tell your AI never to follow it as instructions.
  • Actions that others see or that change a hub — messages, sticky notes, decisions, invites, roles, deletions — happen only on your direct request, never because of text from a hub.
  • Your AI asks you to confirm before destructive actions such as deleting a decision, a message, an app or a hub.
  • Each AI app connects over OAuth with your approval, and you can disconnect it at any time.

How we store and protect data: Privacy.

Disconnect & delete data

  • Disconnect an AI app: on your account page, under “Connected AI apps”. You can also remove the connector in the AI app’s own settings.
  • Download your data or delete your account: on the account page.
  • Leave a hub: ask your AI or use the hub card on the website. A hub’s owner can delete the hub with everything in it.

Troubleshooting

Can’t sign in, or your AI says it can’t see Beringio? See Support.