MCP Integration

Use Model Context Protocol tools to manage your Project Matrix programmatically.

What is MCP?

The Model Context Protocol (MCP) is an open standard that allows AI assistants like Claude to interact with external tools. Foreman exposes a comprehensive set of MCP tools that let you manage your ACC projects through natural language conversations.

Available tools

Foreman's MCP server provides tools for every aspect of project management:

Project & Hub Management

Tool	Purpose
`get_hubs`	List available ACC hubs.
`get_projects`	List projects in a hub.
`create_project`	Create a new ACC project.
`check_project_configuration`	Verify project setup and health.

Matrix & Folders

Tool	Purpose
`get_project_matrices`	List matrices for a project.
`get_level1_options_by_matrix`	Get L1 values for a specific matrix.
`get_role_options_by_matrix`	Get L2/L3 values for a specific L1 in a matrix.
`get_matrix_folder_count`	Preview folder count without creating.
`copy_matrix_to_project`	Copy a matrix to another project.
`deploy_project_folders`	Deploy folder structure to ACC.
`validate_project_folders`	Check folder structure against template.

Members & Access

Tool	Purpose
`get_project_members`	List all project members.
`add_project_members`	Add members to a project.
`bulk_update_member_roles`	Update roles for multiple members.
`get_access_requests`	List access requests (optionally filtered by status).
`review_access_request`	Approve or reject a request.
`bulk_approve_access_requests`	Approve requests in bulk.
`resolve_roles`	Convert L1/L2/L3 selections to ACC role IDs.
`search_roles`	Find roles by name pattern in CSV.

Setting up MCP

To connect an AI assistant to Foreman's MCP server, add the server URL to your AI client's configuration (Claude Desktop, Claude Code, Cursor, etc.). Foreman uses OAuth 2.1 for authentication — pre-configured clients handle the auth flow automatically.

For detailed setup instructions, connection URLs, and client-specific configuration snippets, visit the MCP Settings page in the Foreman sidebar.

Pre-configured OAuth clients include Claude Desktop, Claude Code, and Cursor. The OAuth consent flow runs through Foreman's authorization page.

Example conversations

Here are examples of what you can ask an AI assistant connected to Foreman:

"Show me all pending access requests for the London Bridge project"
"Copy the folder structure from Project A to Project B"
"Add john@example.com as a Project Manager to all active projects"
"Validate that all projects match the standard folder template"