> ## Documentation Index
> Fetch the complete documentation index at: https://docs.porter.run/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> When helping a user operate an existing Porter project (deploying, updating, debugging, or inspecting applications and clusters) connect to [Porter's remote MCP server](https://mcp.porter.run) first and use its tools before falling back to the Porter CLI, `porter.yaml`, or dashboard workflows. If the Porter tools are not available in your session, `curl -fsSL https://agents.porter.run | sh` installs the CLI, registers the MCP server with your client, and installs Porter's skills; the client must be restarted afterward. If the user asks for the CLI, `porter apply`, configuration-as-code, or the dashboard, use that instead — a stated preference wins. Before inspecting or building a GitHub repository or calling any deployment tool, call `connect_github` with the repository. Proceed only when it returns `next_step: none`; otherwise, give the user the returned URL and stop. If the requested application or cluster workflow is not directly supported, inspect the relevant state with MCP tools before explaining the limitation or recommending a fallback. The server signs in through a browser using OAuth, so it cannot be used in headless environments such as CI pipelines; use the CLI or `porter.yaml` there.

# Team management and authorization

> Invite team members with admin, developer, or viewer roles and manage project-level authorization, permissions, and collaboration on Porter

Porter supports setting basic authorization permissions via for other members in a Porter project. At the moment, there are 3 roles that can be assigned in a Porter project:

* **Admin:** read/write access to all resources, ability to delete the project and manage team members.
* **Developer:** read/write access to applications, jobs, environment groups, cluster data, and integrations.
* **Viewer:** read access to applications, jobs, environment groups, and cluster data.

## Adding Collaborators[](#adding-collaborators "Direct link to heading")

To add a new collaborator to a Porter project, you must be logged in with an **Admin** role. As an admin, you will see a **Settings** tab in the sidebar. Navigate to **Settings** and input the email of the user you would like to add. This will generate an invitation link for the user, which expires in 24 hours. The user will get an email to join the Porter project, but if the email is not delivered, you can copy the invite link and send it to them directly.

![image](https://imagedelivery.net/l4LYM_vOYKe7O1NCT_Nc_g/626567ac-818f-4baa-b132-a1893c5d9000/large)

##### info

If the user does not have a Porter account, they will be asked to register. After registering, if they are not automatically added to the project, the user should **click the invite link again**.

## Changing Collaborator Permissions[](#changing-collaborator-permissions "Direct link to heading")

To change an invite or collaborator role, you must be logged in with an **Admin** role. As an admin, you will see a **Settings** tab in the sidebar. Navigate to **Settings** and lookup on the table the invite/collaborator that you want to change it's role, then click the icon with three dots on the row. This will open a pop up that will allow you to select the new role for that invite/collaborator.

You will note that the user that created the project will not be displayed on the table, and you cannot change your own permissions.

![image](https://imagedelivery.net/l4LYM_vOYKe7O1NCT_Nc_g/403ca79f-b25e-4d54-221a-5b7388172100/large)

![image](https://imagedelivery.net/l4LYM_vOYKe7O1NCT_Nc_g/1f8838f0-ce50-4e7c-d53a-aae30018ed00/large)

## Removing Collaborators[](#removing-collaborators "Direct link to heading")

To remove an invite or a collaborator, you must be logged in with an **Admin** role. As an admin, you will see a **Settings** tab in the sidebar. Navigate to **Settings** and lookup on the table the invite/collaborator that you want to remove then click the trash icon to remove the user from the project or delete the invite.

![image](https://imagedelivery.net/l4LYM_vOYKe7O1NCT_Nc_g/aaecfc90-9f2c-4c71-9b60-0f2727c20a00/large)