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

# Projects

> Create and manage projects — the top-level container for all your agents, tools, and policies.

A project is the top-level organizational unit in Devctrl. It contains everything related to a set of AI agents: identities, tasks, tools, policies, and audit logs.

## Create a project

1. Log in to the [Devctrl Console](https://console.devctrl.ai)
2. Click **Create Project** on the dashboard
3. Enter a **name** for your project (e.g., `customer-support`, `data-pipeline`)
4. Set the **default policy action**

## Default policy action

Every project has a default policy action that applies when no active policy release exists, or when no policy rules match a request:

| Action                 | Behavior                                                    |
| ---------------------- | ----------------------------------------------------------- |
| **Deny** (recommended) | Block all tool calls unless a policy explicitly allows them |
| **Allow**              | Allow all tool calls unless a policy explicitly blocks them |

<Tip>
  Start with **Deny** as the default. This follows the principle of least privilege — agents can't do anything until you explicitly permit it.
</Tip>

## Team members

Projects support team collaboration. You can invite other users to your project and assign roles:

* Navigate to **Settings** in your project
* Add members by email
* Assign roles to control who can manage identities, policies, and tools

## Project settings

In the project **Settings** page, you can:

* Rename the project
* Change the default policy action
* Enable or disable MCP (the gateway won't accept requests for this project if disabled)
* Manage team members
* Delete the project

<Warning>
  Deleting a project removes all associated identities, tasks, tools, policies, and audit logs permanently. This action cannot be undone.
</Warning>

## Next steps

<CardGroup cols={2}>
  <Card title="Register MCP servers" icon="server" href="/console/register-mcp-servers">
    Add your first tool server to the project.
  </Card>

  <Card title="Create identities" icon="id-card" href="/console/create-identities">
    Create agent identities with credentials.
  </Card>
</CardGroup>
