Se connecter S'inscrire

Résultats

Ouvrir le terminal complet
Documentation

Model Context Protocol (MCP) Integration

Pro Feature: MCP integration is available for Pro and Enterprise plans. Upgrade your plan

Overview

Connect Claude Code or Codex directly to your AskRobots account with our hosted MCP endpoint. Manage tasks, files, notes, projects, finance workflows, and more through natural language.

Task Management

Create, update, and complete tasks directly from Claude

File Organization

Categorize and manage files with simple commands

AI Integration

Analyze code and generate task descriptions

Quick Start

2 Simple Steps:
  1. Get your API token: Create Token
  2. Add the hosted MCP server to Claude Code: 
    claude mcp add askrobots https://askrobots.com/api/mcp/ -t http -H "Authorization: Token YOUR_TOKEN"

For Codex setup, use the hosted MCP URL with a bearer token in your ~/.codex/config.toml. No npm install required. The MCP server runs on our infrastructure.

Installation

Prerequisites

  • Claude Code CLI (claude command available)
  • AskRobots account with API token

One-Line Setup

No npm install needed - the MCP server runs on our infrastructure:

claude mcp add askrobots https://askrobots.com/api/mcp/ -t http -H "Authorization: Token YOUR_TOKEN"

Replace YOUR_TOKEN with your actual API token.

Configuration

1. Get Your API Token

Visit your API Tokens page and create a new token. Name it "Claude Code" or "Codex" for easy identification.

2. Add MCP Server

Run this command in your terminal:

claude mcp add askrobots https://askrobots.com/api/mcp/ -t http -H "Authorization: Token YOUR_TOKEN"

3. Test Connection

Start Claude Code and try: "List my open tasks"

Tip: Restart Claude Code after adding the MCP server to ensure it picks up the new tools.

Codex Setup

Codex connects to AskRobots using the same hosted MCP endpoint:

https://askrobots.com/api/mcp/

1. Create an API Token

Visit your API Tokens page and create a token for Codex. Codex should use it as a bearer token.

2. Export your token

export ASKROBOTS_MCP_TOKEN="YOUR_TOKEN"

3. Add AskRobots to Codex

codex mcp add askrobots --url https://askrobots.com/api/mcp/ --bearer-token-env-var ASKROBOTS_MCP_TOKEN

4. Alternative: config file setup

If you prefer to manage MCP servers in ~/.codex/config.toml, add:

[mcp_servers.askrobots]
url = "https://askrobots.com/api/mcp/"
bearer_token_env_var = "ASKROBOTS_MCP_TOKEN"

5. Verify MCP in a fresh session

Start a new Codex session and ask it to list MCP resources for askrobots. A working connection should expose 5 built-in resources and 3 parameterized resource templates.

Note: Codex native MCP resource listing has been verified against this endpoint. Claude Code uses the same hosted server, but its client behavior should be validated separately in your environment.

Usage Examples

Task Management
  • "Show my open tasks"
  • "Create a task: Review pull requests"
  • "Mark task abc123 as complete"
  • "Add comment to task: Waiting on client"
File Management
  • "List uncategorized files"
  • "Categorize file as financial/invoices"
  • "Show PDF files from this week"
  • "Get download link for file xyz"
Notes & Knowledge
  • "Create note: Meeting notes..."
  • "Save this link: https://..."
  • "Search notes for API"
  • "Create article about deployment"
AI Features
  • "Analyze this code: [paste]"
  • "Generate tasks for user auth"
  • "Suggest next steps for project"
  • "Create 5 QA test tasks"

Available MCP Capabilities

AskRobots currently exposes 108 MCP tools plus 5 resources and 3 resource templates. The groups below are a quick overview, not a complete list. For the live schema, use askrobots://tools/catalog or the API reference.

  • global_search - Search across all content (projects, tasks, notes, contacts, files, links, articles)

  • list_projects - List all projects (filter by status: active, completed, all)
  • create_project - Create a new project (name, description, status)

  • list_tasks - List tasks with filters (project, status, urgency)
  • get_task - Get task details including comments
  • create_task - Create a new task
  • update_task - Update task (move project, change title/urgency)
  • add_task_comment - Add a comment to a task
  • claim_task - Claim an open task for working
  • submit_task - Submit completed work for approval
  • complete_task - Mark a task as complete

  • list_contacts - List contacts with search
  • get_contact - Get contact details
  • create_contact - Create a new contact
  • update_contact - Update contact info

  • create_note - Create a quick note (optionally attached to project)
  • create_link - Save a bookmark/link
  • create_article - Create a longer-form article

  • get_dashboard_stats - Get AI operations dashboard statistics (wallet, API usage, tasks)

Troubleshooting

Common Issues
Authentication Failed
  • Verify your API token is correct
  • Check token hasn't been revoked
  • Ensure you're using the production URL
Hosted HTTP MCP Not Appearing
  • Use the hosted URL https://askrobots.com/api/mcp/, not a local askrobots-mcp command
  • Restart Claude Code or Codex after changing MCP configuration
No Response from Client
  • Check the AskRobots MCP server is present in your client configuration
  • Restart the client after config changes
  • Check logs in Console.app (Mac) or Event Viewer (Windows)
Codex Cannot See AskRobots
  • Confirm ~/.codex/config.toml includes the AskRobots MCP server entry
  • Confirm ASKROBOTS_MCP_TOKEN is exported before launching Codex
  • Start a completely fresh Codex session after changing config or environment variables
  • Use bearer token config in Codex, not the Claude CLI -H "Authorization: Token ..." command format

Pricing & Limits

Plan MCP Access API Rate Limit Monthly Operations
Free Not available - -
Pro Full access 60 requests/minute 10,000 operations
Enterprise Full access 300 requests/minute Unlimited

View Full Pricing

Need Help?

Check our community forum or email support@askrobots.com