Set up the Socifyr MCP server
The Socifyr MCP server gives any Model Context Protocol client 24 tools to post, schedule, manage drafts, fix expired accounts, read analytics and answer comments. Connect it once and ask your assistant in plain English.
There are two ways to connect:
- Remote server (a URL). Works in claude.ai, ChatGPT, Claude Code, Cursor, VS Code, Windsurf, Gemini CLI and any client that supports remote MCP with custom headers. Nothing to install. Recommended.
- Local server (stdio). Runs as a subprocess on your machine. Use it when a client cannot reach a URL.
Both expose the same 24 tools.
How do I connect Socifyr to my AI client with a URL?
Socifyr hosts a remote MCP endpoint using the Streamable HTTP transport:
https://api.socifyr.com/api/mcpEvery client authenticates the same way, by sending your Socifyr API key (sk_...) in a request header:
Authorization: Bearer sk_your_key_hereCreate a key in the dashboard under API & Integrations. Each key belongs to one workspace, so the connector acts on that workspace. To use another workspace, connect with that workspace's key. See API keys.
Treat the key like a password
Anyone with the key and the URL can post for you. Rotate the key from the dashboard if it leaks. Where a client supports environment-variable interpolation such as ${env:SOCIFYR_API_KEY}, use that instead of pasting the key into a config file you commit.
Where do I configure each client?
| Client | Where to configure | URL field |
|---|---|---|
| claude.ai, Claude Desktop, mobile | Settings, Connectors, Add custom connector | URL and request headers |
| Claude Code | claude mcp add --transport http | command argument |
| ChatGPT | Settings, Connectors (developer mode) | URL and headers |
| Cursor | ~/.cursor/mcp.json | url and headers |
| VS Code (Copilot agent) | .vscode/mcp.json | url and headers, type: "http" |
| Windsurf | ~/.codeium/windsurf/mcp_config.json | serverUrl and headers |
| Gemini CLI | ~/.gemini/settings.json | httpUrl and headers |
Field names and menu labels vary by client version, so check your client's MCP documentation if one of these differs.
How do I add Socifyr to claude.ai or Claude Desktop?
- Open Settings, then Connectors, then Add custom connector.
- Set the remote MCP server URL to
https://api.socifyr.com/api/mcp. - Under Advanced, add a request header:
Authorizationwith the valueBearer sk_your_key_here. - Leave sign-in set to none. The header is the authentication, so you do not need OAuth.
- Save, then enable the Socifyr tools in a chat.
How do I add Socifyr to ChatGPT?
You need a plan with Connectors and developer mode. Create a connector, set the MCP server URL to https://api.socifyr.com/api/mcp, add the header Authorization: Bearer sk_..., save, and enable it in a chat.
How do I add Socifyr to Claude Code?
claude mcp add --transport http socifyr https://api.socifyr.com/api/mcp \
--header "Authorization: Bearer sk_your_key_here"Check with claude mcp list. Remove with claude mcp remove socifyr.
How do I add Socifyr to Cursor?
Edit ~/.cursor/mcp.json for all projects, or .cursor/mcp.json for one:
{
"mcpServers": {
"socifyr": {
"url": "https://api.socifyr.com/api/mcp",
"headers": {
"Authorization": "Bearer ${env:SOCIFYR_API_KEY}"
}
}
}
}Cursor fills ${env:SOCIFYR_API_KEY} from your environment. Reload Cursor and enable socifyr in Settings, MCP.
How do I add Socifyr to VS Code?
Create .vscode/mcp.json in your workspace:
{
"servers": {
"socifyr": {
"type": "http",
"url": "https://api.socifyr.com/api/mcp",
"headers": {
"Authorization": "Bearer ${env:SOCIFYR_API_KEY}"
}
}
}
}Open Copilot Chat in Agent mode and confirm the Socifyr tools are listed.
How do I add Socifyr to Windsurf?
Edit ~/.codeium/windsurf/mcp_config.json. The key is serverUrl, not url:
{
"mcpServers": {
"socifyr": {
"serverUrl": "https://api.socifyr.com/api/mcp",
"headers": {
"Authorization": "Bearer ${env:SOCIFYR_API_KEY}"
}
}
}
}How do I add Socifyr to Gemini CLI?
Edit ~/.gemini/settings.json. The key is httpUrl:
{
"mcpServers": {
"socifyr": {
"httpUrl": "https://api.socifyr.com/api/mcp",
"headers": {
"Authorization": "Bearer ${SOCIFYR_API_KEY}"
}
}
}
}Run gemini mcp list to confirm.
How do I connect any other MCP client?
Use these three values. Field names vary by client.
- URL:
https://api.socifyr.com/api/mcp - Transport: Streamable HTTP. Clients send HTTP POST and the server replies with JSON.
- Auth: an
Authorization: Bearer sk_...request header
How does the remote server behave?
- It is stateless. Each request is independent, with no session to keep alive.
- It only accepts
POST. AGETorDELETEreturns 405 withMethod not allowed. Use POST for MCP requests. - A missing or malformed key returns 401:
Missing API key. Send an "Authorization: Bearer sk_..." header.The header must start withBearer sk_. An unknown key returnsInvalid API key. - The endpoint allows 120 requests per minute per IP address.
- Every tool call goes through the REST API with your key, so plan limits, permissions and API key guardrails apply as usual.
How do I use my own self-hosted instance?
The endpoint is {API_URL}/api/mcp, for example https://api.mycompany.com/api/mcp. Use a key from that instance. When the instance has MCP OAuth sign-in enabled, a request without a key gets a 401 with a WWW-Authenticate header so clients can start an OAuth flow instead.
How do I run the MCP server locally over stdio?
The local server is the npm package @socifyr/mcp. It talks to Socifyr's REST API using environment variables:
| Variable | Required | Description |
|---|---|---|
SOCIFYR_API_KEY | yes | API key (sk_...) |
SOCIFYR_API_URL | no | Custom API URL for self-hosted, default https://api.socifyr.com/api |
If SOCIFYR_API_KEY is missing the server writes an error to stderr and exits with code 1.
Claude Desktop, Cursor and Windsurf (local)
Add this to the client's MCP config (claude_desktop_config.json, mcp.json and so on):
{
"mcpServers": {
"socifyr": {
"command": "npx",
"args": ["-y", "@socifyr/mcp"],
"env": {
"SOCIFYR_API_KEY": "sk_..."
}
}
}
}If you installed the package globally (npm install -g @socifyr/mcp) you can use "command": "socifyr-mcp" with no args. Restart the client afterwards.
Claude Code (local)
claude mcp add socifyr \
--env SOCIFYR_API_KEY=sk_... \
-- npx -y @socifyr/mcpSelf-hosted (local)
Add SOCIFYR_API_URL to the env block:
{
"env": {
"SOCIFYR_API_KEY": "sk_...",
"SOCIFYR_API_URL": "https://api.mycompany.com/api"
}
}How do I check that the MCP connection works?
Ask your assistant:
List my Socifyr connections.
It should call list_connections and read back your slugs, with a flag next to any account that is expiring or needs reconnecting. Then try:
Post "just shipped a new feature" to LinkedIn and X.
It should resolve your slugs and call post_text. If something fails, see MCP errors.
FAQ
Does the MCP server work with more than one workspace?
One server connection acts on one workspace, the one the API key belongs to. Add a second connector with the other workspace's key. See workspaces.
Is OAuth required for claude.ai?
No. The Authorization header is the authentication. Choose no sign-in when the client asks.
Remote or local: which should I use?
Use remote unless the client cannot reach a URL. Remote needs no install and has nothing to update. Local needs Node.js 18 or newer.