sf-agent-framework/sf-core/mcp/README.md

AI Agent Orchestration Framework for Salesforce Development - Two-phase architecture with 70% context reduction

# Salesforce MCP (Model Context Protocol) Support

This directory contains resources for integrating Salesforce with the Model
Context Protocol (MCP), enabling AI agents to interact with Salesforce data and
services through standardized interfaces.

## Directory Structure

- **servers/** - MCP server implementations for Salesforce APIs
- **clients/** - MCP client configurations for various AI platforms
- **registry/** - Enterprise MCP server registry and governance policies

## Overview

The Model Context Protocol (MCP) is an open standard that enables seamless
communication between AI applications and data sources. With Salesforce's
adoption of MCP in Agentforce 3 (July 2025), this integration provides:

1. **Standardized Access** - Unified interface for AI agents to interact with
   Salesforce
2. **Multi-System Integration** - Connect Salesforce with other enterprise
   systems
3. **Enterprise Governance** - Centralized control over AI-tool interactions
4. **Developer Productivity** - Natural language interfaces for Salesforce DX
   operations

## Key Components

### MCP Servers

Pre-built MCP servers for common Salesforce integrations:

- **Salesforce DX Server** - Development operations via natural language
- **REST API Server** - Standard Salesforce object access
- **MuleSoft Connector** - API integration and orchestration
- **Heroku AppLink** - Scalable infrastructure for MCP hosting

### MCP Clients

Configurations for AI platforms:

- **Agentforce 3** - Native MCP client (Pilot July 2025)
- **Claude Code** - MCP discovery and tool integration
- **GitHub Copilot** - Enhanced Salesforce development
- **Custom Agents** - Framework for building specialized AI agents

### Registry & Governance

Enterprise-grade controls:

- **Server Registry** - Centralized MCP server discovery
- **Security Policies** - Access control and rate limiting
- **Audit Trails** - Comprehensive activity logging
- **Compliance Templates** - GDPR, HIPAA, SOC2 configurations

## Getting Started

1. Choose your integration scenario:
   - Development automation (Salesforce DX)
   - Data access (REST API)
   - System integration (MuleSoft)
   - Custom functionality (Build your own)

2. Select appropriate MCP server template from `servers/`

3. Configure security and governance in `registry/`

4. Deploy using provided workflows in
   `../workflows/salesforce-mcp-implementation.md`

## Resources

- [Salesforce MCP Documentation](https://developer.salesforce.com/docs/platform/mcp)
- [Model Context Protocol Specification](https://modelcontextprotocol.io)
- [Agentforce 3 Preview](https://developer.salesforce.com/agentforce3)