Corcava logo Le seul outil métier dont vous avez besoin Corcava
Menu

Configuration Corcava MCP pour Windsurf : outils de gestion de projet dans l'IDE

Connectez Windsurf à Corcava via MCP pour avoir la gestion de projet directement dans votre IDE. Ce guide décrit les étapes de configuration, où coller l'endpoint et le header, et une première prise en main.

Prérequis

Étape 1 : Obtenir votre clé API Corcava

  1. Log in to Corcava
  2. Navigate to SettingsIntegrations
  3. Find the Public API section
  4. Click Add API Key
  5. Copy the key immediately (it's only shown once)
  6. Store it securely - you'll need it in the next step

Step 2: Open Windsurf Settings

Windsurf uses a settings UI for MCP configuration (no file editing required):

  1. Open Windsurf
  2. Click the Settings icon (gear icon) or use Cmd+, (macOS) / Ctrl+, (Windows/Linux)
  3. Navigate to AI or MCP section
  4. Find the MCP Servers configuration

Step 3: Add Corcava MCP Server

In the MCP Servers section, add a new server with these details:

Configuration Values

  • Name: corcava (or any name you prefer)
  • URL: https://app.corcava.com/mcp
  • Authorization: Bearer YOUR_API_KEY

⚠️ Important

  • Replace YOUR_API_KEY with the actual API key you copied
  • There must be a space between "Bearer" and your API key

Step 4: Save and Restart Windsurf

  1. Click Save or Apply in the settings
  2. Completely quit Windsurf
  3. Restart Windsurf

Step 5: Verify Tools Are Available

After restarting, verify that Windsurf's AI can see Corcava's MCP tools:

Verification Prompt

In Windsurf's AI chat, ask:

"What MCP tools are available from Corcava?"

Step 6: First-Use Walkthrough

Try this workflow to test your connection and create your first task:

Create a Task and Link to Coding Session

Prompt:

"Create a task in Corcava for implementing the user authentication feature. Show me what you'll create before creating it."

FAQ: Permissions and Write Safety

Q: What permissions does the API key have?

A: The API key provides full access to your Corcava workspace. Always keep your API key secure and never share it.

Q: How do I prevent accidental writes?

A: Use confirmation patterns in your prompts. Ask AI to show what it will create/update before doing it.

En savoir plus sur les workflows d'écriture sécurisés →

Troubleshooting

❌ Auth Headers Not Being Sent

Symptom: Connection works but tool calls fail with 401 errors

Read Windsurf auth troubleshooting →

❌ Tools Not Showing Up

Completely quit and restart Windsurf. Verify endpoint URL and auth header format.

Read tools troubleshooting guide →

Connecter Windsurf à Corcava

Bring project management into your IDE

Aucune carte bancaire requise