MCP Server Setup Guide
Overview
VibeMarketing's Model Context Protocol (MCP) server allows AI assistants like Claude, ChatGPT, and other compatible tools to interact with your social media accounts and posts programmatically.
Features
The MCP server provides the following tools:
- get_x_accounts: List connected X/Twitter accounts
- get_linkedin_accounts: List connected LinkedIn accounts
- get_posts: Retrieve scheduled or published posts
- schedule_post: Schedule new social media posts
- get_subscription_status: Check subscription status and usage
Setup Instructions
Claude Code (Recommended)
Claude Code provides the simplest setup experience with automatic authentication.
Step 1: Install MCP in Your Project Directory
Navigate to your project directory where you want to install the MCP, then run:
claude mcp add -s local -t http vibemarketing https://vibemarketing.ninja/mcp
💡 Tip: Run this command in a directory where you store your marketing content and documents. Claude will have access to these files as context when generating posts.
Step 2: Authenticate with VibeMarketing
After running the command above:
- Start Claude Code by running
claude
in your terminal - Run the command
/mcp
in Claude Code - Select vibemarketing from the list of MCP servers
- Press Enter to confirm
- Choose "Authenticate" from the menu
- Your browser will open - log in to your VibeMarketing account
- Authorize the connection when prompted
✅ You're all set! Claude Code can now access your VibeMarketing account to schedule posts, view your social accounts, and manage your content.
Best Practice: Create a dedicated folder for your marketing work (e.g., ~/marketing
) and install the MCP there. Store your brand guidelines, previous posts, and other relevant documents in this folder for Claude to use as context.
Claude Desktop
For Claude Desktop users, add VibeMarketing as a custom connector:
Step 1: Open Claude Desktop Settings
Go to Settings → Connectors → Add custom connector
Step 2: Add VibeMarketing Connector
Enter the following details:
- Name:
VibeMarketing
- Remote MCP server URL:
https://vibemarketing.ninja/mcp
Step 3: Click Add
The connector will appear in your list. You'll be prompted to authenticate when you first use the MCP tools.
Note: Claude Desktop will handle authentication automatically through OAuth. Just log in with your VibeMarketing account when prompted.
ChatGPT (Developer Mode)
ChatGPT Plus users with Developer Mode enabled can add VibeMarketing as an MCP server.
Step 1: Open ChatGPT Settings
- Click on your profile picture in the bottom left
- Go to Settings & Beta
- Select Beta features
- Enable Developer mode if not already enabled
Step 2: Add MCP Server
- In ChatGPT, click on the paperclip icon (attachment button)
- Select Configure MCP servers
- Click Add MCP Server
- Enter the following details:
- Name:
vibemarketing.ninja
- Description (optional):
Tweet and LinkedIn scheduler
- MCP Server URL:
https://vibemarketing.ninja/mcp
- Authentication: Select
OAuth
- Check the "I trust this application" checkbox
- Click Create
Step 3: Authenticate
- When you first use the MCP server, you'll be prompted to authenticate
- Log in with your VibeMarketing account
- Authorize the connection
⚠️ Note: ChatGPT MCP support is in beta and may have limitations compared to Claude implementations.
Available MCP Tools
Once connected, your AI assistant will have access to these tools:
Social Media Management
- get_x_accounts - List your connected X/Twitter accounts
- get_linkedin_accounts - List your connected LinkedIn accounts
- schedule_post - Schedule posts to your social media accounts
- get_posts - View your scheduled and published posts
Account Management
- get_subscription_status - Check your subscription plan and usage limits
Example Usage
Once configured, you can ask your AI assistant to:
- "Show me my connected social media accounts"
- "Schedule a post about our new product launch for tomorrow at 2pm"
- "What posts do I have scheduled for this week?"
- "Check my subscription status and remaining post quota"
- "Help me write and schedule a LinkedIn post about industry trends"
Security
- OAuth 2.0 Authentication: Secure authentication flow with PKCE support
- Token Expiration: Access tokens expire after 1 hour for security
- Revocable Access: You can revoke MCP access at any time from your account settings
- Encrypted Communications: All API calls use HTTPS
Troubleshooting
Common Issues
Authentication Failed
- Ensure you're logged in to VibeMarketing
- Check that you've authorized the MCP client
- Try logging out and back in to VibeMarketing
Tools Not Available
- Restart your AI assistant after adding the MCP server
- Verify the MCP server URL is correct:
https://vibemarketing.ninja/mcp
- Check your internet connection
Connection Errors
- Ensure you're using the full URL including
/mcp
- Check if your firewall or VPN is blocking the connection
- Try refreshing your authentication
Need Help?
- Documentation: Visit VibeMarketing MCP Settings for the latest setup instructions
- GitHub Issues: Report bugs or request features on our GitHub repository
- Support: Join our community on Discord.
Updates
The MCP server is continuously improved. Check back regularly for new features and tools!