Agiflow
DocumentationBlogPricing

Documentation

IntroductionGetting Started
Spec + Task ManagementReliable Agent ExecutionSecurity & Governance
Claude CodeCursor
@agiflowai/agent-cli@agiflowai/powertool
Project MCPTask MCPScaffold MCPOpen SourceArchitect MCPOpen SourceOne MCPOpen Source

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.

How Project MCP Works

1

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.
2

Authentication & Authorization

The MCP server validates user identity, organization membership, and project ownership before providing access to project management tools.
3

Tool Registration

The builder pattern registers only the necessary tools (create, read, update, delete, list) based on the user's permissions and project context.
4

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.

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

Next Steps

Explore Task MCP

Learn how Task MCP enables intelligent task management and workflow automation.

Learn about Task MCP

Getting Started

Set up your first project with Project MCP enabled and start using Claude with full context.

Get started
Try Project MCP
Agiflow
BlogTermsPrivacy© 2025 Agiflow. All rights reserved.