Quick Start

Quick Start Guide

This guide will get you up and running with TeamLoop in just a few minutes.

Prerequisites

Before you begin, you’ll need:

• A TeamLoop account (sign up at teamloop.io)
• Claude Desktop or another MCP-compatible client
• At least one of: GitHub, Notion, or Linear account

Step 1: Connect Your Integrations

1. Log into TeamLoop at app.teamloop.io
2. Navigate to Settings > Integrations
3. Click Connect for each tool you want to use:
   • GitHub - Access repos, issues, PRs, and discussions
   • Notion - Access pages and databases
   • Linear - Access issues and projects
4. Authorize TeamLoop to access your data

Tip

Start with GitHub if you’re unsure. It provides rich data for building your knowledge graph.

Step 2: Configure MCP

Add TeamLoop to your Claude Desktop configuration:

macOS

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "teamloop": {
      "command": "npx",
      "args": ["-y", "@teamloop/mcp-server"],
      "env": {
        "TEAMLOOP_API_KEY": "your-api-key-here"
      }
    }
  }
}

Windows

Edit %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "teamloop": {
      "command": "npx",
      "args": ["-y", "@teamloop/mcp-server"],
      "env": {
        "TEAMLOOP_API_KEY": "your-api-key-here"
      }
    }
  }
}

Get Your API Key

1. Go to Settings > API Keys in TeamLoop
2. Click Create API Key
3. Copy the key and paste it into your config

Step 3: Restart Claude Desktop

After saving the configuration, restart Claude Desktop to load TeamLoop.

You should see “teamloop” listed in Claude’s MCP servers when you start a new conversation.

Step 4: Make Your First Query

Try asking Claude:

“Search my GitHub for authentication-related discussions”

Claude will use TeamLoop to:

1. Query your connected GitHub
2. Return relevant results
3. Prompt you to extract knowledge

Step 5: Save Knowledge

When Claude returns results, it will suggest extracting entities. For example:

Found 5 results about authentication...

## Extraction Instructions
Based on these results, I'll extract:
- Decision: "Migrate to OAuth 2.0"
- Component: "Auth Service"
- Person: "Alice (author)"

Confirm the extraction to build your knowledge graph.

Step 6: Explore Temporal Queries

Now that you have some knowledge, try temporal queries:

Point-in-Time Query

“What did we know about authentication on January 1st?”

Evolution Query

“How has our authentication approach evolved from 2024-01-01 to today?”

Compare Query

“Compare our auth decisions from Q1 vs Q4 2024”

Common First Queries

Here are some queries to try:

Query	What It Does
”Search GitHub for architecture decisions”	Find ADR-like content
”What authentication approaches have we discussed?”	Build auth knowledge
”Search Notion for product roadmaps”	Import planning docs
”Find all decisions about database technology”	Track tech choices
”Show me the timeline of infrastructure changes”	Temporal view

Next Steps

Now that you’re set up:

1. MCP Tools Reference - Learn all available tools
2. Knowledge Graphs - Understand entity types
3. Subgraphs - Organize your knowledge
4. Synthesis - Generate documents from knowledge

Troubleshooting

Claude doesn’t show TeamLoop tools

• Verify your API key is correct
• Check that the config JSON is valid (use a JSON validator)
• Restart Claude Desktop completely

No results from queries

• Ensure integrations are connected in TeamLoop settings
• Check that you have access to the repos/pages you’re querying
• Try a broader search term

Extraction fails

• Ensure your Voyage API key is configured (for embeddings)
• Check the TeamLoop logs for errors

Need more help? Check our support page or join the community Discord.