How to add an MCP server to OpenCode

Checked against OpenCode's documentation on Oct 26, 2026. Commands and config blocks are generated from the same install data as each listing page.

1. 1. Choose a server and see what it needs

   OpenCode reads both a global file and a project file, so pick which one should hold each server before you edit anything.

   • Playwright MCP: runs locally, no key needed.
   • Figma MCP Server: hosted, connect by URL, no key needed.
   • Firecrawl MCP Server: runs locally, can take FIRECRAWL_API_KEY.
   • Where OpenCode can keep a server: global (~/.config/opencode/opencode.json) and project (opencode.json). Files are merged.

2. 2. Add a local server (Playwright MCP)

   OpenCode writes the launch command as a single array under mcp, with a type of local, instead of separate command and args keys.

   {
     "$schema": "https://opencode.ai/config.json",
     "mcp": {
       "playwright-mcp": {
         "type": "local",
         "command": [
           "npx",
           "-y",
           "@playwright/mcp@0.0.82"
         ],
         "enabled": true
       }
     }
   }

   Copy

3. 3. Add a remote server (Figma MCP Server)

   Figma MCP Server is a remote entry with a url and no command array.

   {
     "$schema": "https://opencode.ai/config.json",
     "mcp": {
       "figma": {
         "type": "remote",
         "url": "https://mcp.figma.com/mcp",
         "enabled": true
       }
     }
   }

   Copy

   • If the server needs OAuth, run opencode mcp auth with the server name.

4. 4. Keep API keys out of the file (Firecrawl MCP Server)

   The Firecrawl MCP Server key is wired through an environment block named environment, using OpenCode's own brace syntax such as {env:FIRECRAWL_API_KEY}.

   {
     "$schema": "https://opencode.ai/config.json",
     "mcp": {
       "firecrawl-mcp-server": {
         "type": "local",
         "command": [
           "npx",
           "-y",
           "firecrawl-mcp@3.34.1"
         ],
         "enabled": true,
         "environment": {
           "FIRECRAWL_API_KEY": "{env:FIRECRAWL_API_KEY}"
         }
       }
     }
   }

   Copy

   export FIRECRAWL_API_KEY="paste-your-value-here"

   Copy

   • Config values accept {env:VARIABLE_NAME} and {file:path}, so a token can stay in your environment. An unset variable becomes an empty string.
   • OpenCode expands {env:NAME} in the config, so the value stays in your environment.
   • FIRECRAWL_API_KEY (optional): Your API key for Firecrawl.

5. 5. Restart or reload if the server does not appear

   If the server is missing after you save opencode.json, this step covers what the docs say, and what they leave out, about restarting.

   • The docs do not say whether editing opencode.json needs a restart.
   • Each MCP server adds its tool definitions to the model's context, so enable only the ones you need.

opencode mcp list