Skip to main content
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
  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:
ActionBehavior
Deny (recommended)Block all tool calls unless a policy explicitly allows them
AllowAllow all tool calls unless a policy explicitly blocks them
Start with Deny as the default. This follows the principle of least privilege — agents can’t do anything until you explicitly permit it.

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
Deleting a project removes all associated identities, tasks, tools, policies, and audit logs permanently. This action cannot be undone.

Next steps

Register MCP servers

Add your first tool server to the project.

Create identities

Create agent identities with credentials.