Smallforce Smallforce Docs

SmallForce MCP for VS Code Copilot

Connect SmallForce to GitHub Copilot in VS Code so Copilot’s agent mode can manage your social media, CRM contacts, inbox conversations, Google reviews, and call analytics.

Prerequisites

Setup

1. Create the MCP config file

In your project root, create a .vscode/mcp.json file:

{
  "servers": {
    "smallforce": {
      "type": "http",
      "url": "https://mcp.smallforcehq.com/mcp",
      "headers": {
        "Authorization": "Bearer sf_sk_live_your_api_key_here"
      }
    }
  }
}

Replace sf_sk_live_your_api_key_here with your actual API key.

2. Enable MCP in Copilot settings

Open VS Code Settings (Cmd + ,) and search for “MCP”. Ensure “GitHub Copilot → MCP: Enabled” is checked.

3. Verify

Open the Copilot Chat panel (Cmd + Shift + I) and switch to Agent mode (@workspace). Ask Copilot to list your SmallForce accounts to verify the connection.

Usage

In Copilot’s agent mode chat:

"List my SmallForce social accounts"
"Create a draft Instagram post about our new feature"
"Show me recent inbox conversations"
"Reply to the latest 1-star Google review with a helpful message"
"Search contacts for anyone at Acme Corp"

Project vs global config

  • .vscode/mcp.json — applies to one project, commit it to share with your team
  • User settings — settings.json with "mcp.servers" key for global access

Troubleshooting

  • Tools not showing: Ensure you’re in Agent mode, not regular Copilot chat
  • MCP option missing: Update VS Code to version 1.99 or later
  • Auth errors: Verify your API key format (sf_sk_live_...)
  • Config not loading: Check that .vscode/mcp.json is in your workspace root