/agentai-mcp-server

Primary LanguageJavaScript

Agent.AI MCP Server

This is an externally deployable version of the Agent.AI MCP Server, designed to be hosted on Vercel and called from other applications.

Deployment Instructions

Prerequisites

  • GitHub account
  • Vercel account (free tier works)
  • Git installed locally

Steps to Deploy

  1. Create a new GitHub repository

    git init
git add .
git commit -m "Initial commit: Agent.AI MCP Server"
git branch -M main
git remote add origin https://github.com/YOUR_USERNAME/agentai-mcp-server.git
git push -u origin main

  2. Deploy to Vercel

    • Go to vercel.com
    • Click "New Project"
    • Import your GitHub repository
    • Vercel will automatically detect it as a Node.js project
    • Click "Deploy"

  3. Get your deployment URL

    • After deployment, Vercel will provide a URL like: https://your-project-name.vercel.app
    • This is your MCP server endpoint

Usage

Once deployed, you can call your MCP server from other applications using the Vercel URL.

Example Usage

// In your other app
const mcpServerUrl = 'https://your-project-name.vercel.app';

// Make requests to your MCP server
fetch(mcpServerUrl + '/your-endpoint')
  .then(response => response.json())
  .then(data => console.log(data));

Local Development

To run locally:

npm install
npm start

The server will start on http://localhost:3000

Configuration

  • Port: Automatically set by Vercel, or defaults to 3000 locally
  • Environment Variables: Can be set in Vercel dashboard under Project Settings > Environment Variables

Troubleshooting

  • Ensure your @agentai/mcp-server package is publicly available
  • Check Vercel deployment logs if issues occur
  • Verify your GitHub repository is public or Vercel has access

Important: Authentication Setup

1. Configure Agent.AI API Token

Your MCP server requires an Agent.AI API token to authenticate with Agent.AI services:

  1. Get your API token from Agent.AI
  2. Go to your Vercel project dashboard
  3. Click "Settings" → "Environment Variables"
  4. Add a new variable:
    • Name: API_TOKEN
    • Value: Your Agent.AI API token
  5. Redeploy the project

2. Disable Vercel Authentication

To allow external access to your MCP server, you MUST disable Vercel's built-in authentication:

  1. Go to your Vercel project dashboard
  2. Click "Settings" → "Security"
  3. Disable "Password Protection" and "Vercel Authentication"
  4. Save changes

3. Test Authentication

After setup, your endpoints will return:

  • ✅ "authentication": "configured" - Ready to use
  • ❌ "authentication": "missing" - API_TOKEN required