Project MCP
Provide Claude with deep project context including file structure, dependencies, and codebase understanding for intelligent development assistance.
Overview
Project MCP provides Claude Code with comprehensive project management capabilities within Agiflow's scoped MCP architecture. It enables Claude to create, read, update, and delete projects while maintaining strict organizational boundaries and user ownership controls.
As a project-scoped MCP server, it automatically knows the project context and provides the appropriate tools for project-level operations. Each project gets its own dedicated MCP instance, ensuring precise context without cross-contamination between different projects.
Available MCP Tools
create-project
Create a new project for the authenticated user with name, description, color, and icon customization.
- • Project name and description
- • Organization assignment
- • Color and icon customization
list-projects
List projects with pagination, filtering, and sorting capabilities for the authenticated user.
- • Pagination (limit/offset)
- • Search functionality
- • Sorting and ordering
get-project
Retrieve detailed information about a specific project by ID, including all project metadata.
- • Project details and metadata
- • Ownership information
- • Configuration settings
update-project
Update existing project properties including name, description, color, icon, and archive status.
- • Edit project properties
- • Archive/unarchive projects
- • Update visual settings
delete-project
Permanently delete a project with proper authorization checks and ownership validation.
- • Ownership verification
- • Permanent deletion
- • Safety checks
Project Resources
Access individual project data and projects list as MCP resources for enhanced context.
- • project://{id} resource
- • projects://list resource
- • JSON formatted data
How Project MCP Works
Scoped MCP Server Creation
When Claude connects to a project, Agiflow creates a dedicated Project MCP server instance with project-level permissions and automatic context awareness.
Authentication & Authorization
The MCP server validates user identity, organization membership, and project ownership before providing access to project management tools.
Tool Registration
The builder pattern registers only the necessary tools (create, read, update, delete, list) based on the user's permissions and project context.
Organizational Boundaries
All operations respect organizational boundaries through the unique project scoped and API keys, ensuring users can only access projects within their organization.
Common Use Cases
Project Initialization
"Create a new project called 'AI Dashboard' with blue theme and analytics icon for our organization"
Project Discovery
"List all my projects" or "Find projects containing 'API' in the name" with pagination and filtering.
Project Configuration
"Update the project description" or "Change the project icon to a gear" or "Archive this project".
Project Information Retrieval
"Show me the details of this project" or "Get project metadata" for context-aware assistance.
MCP Context & Authorization
Context Information
The Project MCP automatically receives context information when initialized:
- userId - Authenticated user identifier
- memberId - Organization member identifier
- organizationId - Organization scope boundary
- projectId - Optional project scope (when available)
Security & Authorization
- Organizational boundaries enforced via OrganizationDurableObject
- User ownership validation for all project operations
- Project existence checks before any modifications
- Builder pattern for selective tool registration
Best Practices
📁 Descriptive Project Names
Use clear, descriptive project names that reflect the project's purpose. This helps with project discovery and makes it easier for team members to find the right project.
📝 Comprehensive Descriptions
Provide detailed project descriptions that explain the project's goals, target audience, and key features. This context helps Claude provide more relevant assistance.
🎨 Consistent Visual Identity
Use meaningful colors and icons for your projects to create visual organization. Group related projects with similar visual themes for better navigation.
🗂️ Project Lifecycle Management
Archive completed or inactive projects to keep your project list focused. Use the update functionality to keep project information current as requirements evolve.
Troubleshooting
Project not found errors
• Verify you have the correct project ID
• Ensure you're a member of the organization that owns the project
• Check that the project hasn't been deleted or archived
Permission denied when creating or modifying projects
• Confirm you're authenticated with the correct Agiflow account
• Verify your organization membership and permissions
• For updates/deletes, ensure you're the project owner
Claude agent session connection issues
• Ensure you're using the correct agent session ID
• Verify the Project MCP server is properly configured
• Check that the organization context is correctly set