EvoHub Docs Sign in
EnglishEN

Getting started

Organizations and teams

Use with AI
View as MarkdownThis page as plain text, for pasting into an AI tool Open in ClaudeAsk Claude questions about this page Open in ChatGPTAsk ChatGPT questions about this page
Connect to Cursor / VS Code / ClaudeSearch and read these docs from your AI tool (MCP server)

MCP server URL

https://docs-dev.evohub.io/mcp

Claude Code

claude mcp add --transport http evohub-docs-docs https://docs-dev.evohub.io/mcp

Claude (claude.ai and Claude Desktop): Settings → Connectors → Add custom connector, and paste the URL above.

Claude Desktop — claude_desktop_config.json

{
  "mcpServers": {
    "evohub-docs-docs": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://docs-dev.evohub.io/mcp"
      ]
    }
  }
}

Cursor — ~/.cursor/mcp.json

{
  "mcpServers": {
    "evohub-docs-docs": {
      "url": "https://docs-dev.evohub.io/mcp"
    }
  }
}

VS Code — .vscode/mcp.json

{
  "servers": {
    "evohub-docs-docs": {
      "type": "http",
      "url": "https://docs-dev.evohub.io/mcp"
    }
  }
}

An organization is the workspace everything in EvoHub belongs to: alerts, schedules, monitors, status pages, boards, docs sites, changelogs, members and the bill. Teams are groups of people inside an organization. This page explains how to work with both.

Organizations

Every organization is separate from every other. Data created in one organization is never visible from another, and each organization has its own members, roles, teams, API keys and billing.

You can belong to several organizations, with a different role in each:

  • Your personal organization is created when you sign up. You are its Owner, and it cannot be deleted.
  • Organizations you create. Open the organization switcher in the top bar, choose New Organization, enter an Organization name and select Create. You become its Owner. One account can own up to 5 organizations.
  • Organizations you are invited to. See Join through an invitation.

My Account → Settings lists every organization you belong to and your role in each.

Switch organizations

Open the organization switcher in the top bar and pick an organization. The console reloads in that organization: every product, member list and bill you see is now that organization's.

If the organization you switch to requires two-factor authentication and you have not set it up, EvoHub asks you to set it up first. See Two-factor authentication.

Rename an organization

Open Organization → Org Settings, change Organization Name and select Save. This needs the Organization Settings write permission, which Owners and Admins have.

Invite people

Inviting is free: EvoHub never charges per member.

Open the invite dialog

Go to Organization → Members and select Invite Member.

Enter the email address

Type the address of the person you want to invite.

Choose what they can do

Pick one or more roles, and optionally one or more teams. A team brings the roles that team holds. You can only give roles whose permissions you hold yourself. If you cannot see roles, you choose between Member and Viewer (and Admin, if you are an administrator).

Send the invitation

EvoHub emails an invitation link. The person holds the roles and teams you picked from the moment they accept.

Inviting needs the Members → Invite permission. The default Member and Admin roles include it.

Manage pending invitations

Organization → Invitations lists pending invitations. From there you can resend an invitation email or cancel an invitation. An invitation is valid for 7 days; after that, send a new one.

Join through an invitation

Open the link in the invitation email.

  • If you already have an EvoHub account, sign in with the email address the invitation was sent to and accept. An invitation can only be accepted by the account with that exact email address.
  • If you are new to EvoHub, create your account from the invitation page. Because the invitation already proved you own the email address, you do not need to verify it again.

After you accept, the organization appears in your organization switcher.

Remove a member

Go to Organization → Members, select Remove on the member's row and confirm. They lose access to the organization immediately. Removing members needs the Members → Write permission, which Owners and Admins have. The Owner cannot be removed, and you cannot remove yourself this way.

A removed member's personal API keys for that organization stop working at the same time. See API keys and scopes.

Teams

A team is a named group of people in an organization. Teams do two things:

  • Scope work. Schedules, monitors, boards and retros can belong to a team. Work that belongs to a team is visible to that team's members; work that belongs to no team is visible across the organization. Owners and Admins see every team's work.
  • Carry roles. Give a team a role and everyone in the team holds that role for as long as they are in it. Remove someone from the team and they lose it.

Create a team

Open Teams

Go to Organization → Teams and select Create Team.

Name it

Enter a Name and, optionally, a description of what the team owns.

Add people and roles

Open the team, add people from your organization, and give the team a role if its members should gain permissions through it.

Creating and editing teams needs the Teams → Write permission, which the default Member and Admin roles include. Everyone can see the teams they are in, even without permission to read all teams.

Tip

A team that holds no role gives its members nothing extra. That is fine when you only use the team to scope work; give it a role when membership should also grant permissions.

Delete an organization

Only the Owner can delete an organization, and a personal organization cannot be deleted.

Open Org Settings

Go to Organization → Org Settings. The Danger Zone section is visible to the Owner.

Confirm

Select Delete Organization, type the organization's name, and select Delete.

Danger

Deleting an organization is permanent. Its members lose access immediately, and its data in every product (On-Call, Uptime, status pages, retros, boards, docs sites and changelogs) is removed. This cannot be undone. Billing records that make up invoices already issued are kept, as described in Privacy and your data.

Last updated