LoginGet Started

Vinculación de Projects

Novedad en v0.1.21

Vincula tus directorios locales a Projects de ContextForge para filtrado de contexto automático.

¿Qué es la vinculación de Projects?

La vinculación de Projects crea una conexión entre tu directorio de código local y un Project de ContextForge en la nube. Una vez vinculado, todas las consultas y operaciones de memoria filtran automáticamente hacia los Spaces de ese proyecto.

Tus proyectos locales              ContextForge Cloud
─────────────────────────          ──────────────────
~/code/frontend-app/               Project: "Frontend"
  └── .contextforge ──────────→    ├── Space: "Components"
                                   ├── Space: "State Management"
                                   └── Space: "UI Guidelines"

~/code/backend-api/                Project: "Backend"
  └── .contextforge ──────────→    ├── Space: "API Docs"
                                   └── Space: "Database Schema"

~/code/mobile-app/                 Project: "Mobile"
  └── .contextforge ──────────→    └── Space: "React Native"

Ventajas

Consultas enfocadas

Busca solo en los Spaces relevantes. Sin mezclar documentación de frontend con notas de backend.

Contexto automático

No necesitas indicar qué proyecto usar. Claude lo sabe a partir de tu directorio.

Colaboración en equipo

Los miembros del equipo pueden vincularse al mismo proyecto y compartir conocimiento.

Cómo vincular un Project

Paso 1: Ver los Projects disponibles

Primero, pídele a Claude que te muestre los proyectos disponibles:

# En Claude Code

"Link this project to ContextForge"

# O de forma más concreta:
"What ContextForge projects do I have?"

Claude te mostrará los proyectos disponibles para elegir.

Paso 2: Vincular a un Project

# Vincular a un proyecto existente

"Link this directory to project Frontend"

# O crear un nuevo proyecto y vincularlo

"Link this to a new project called Mobile App"

Paso 3: Verificar el vínculo

"What project is linked to this directory?"

Esto te mostrará el proyecto vinculado y todos sus Spaces.

El archivo .contextforge

Al vincular un proyecto, ContextForge crea un archivo .contextforge en la raíz de tu directorio:

# .contextforge

{
  "project_id": "abc-123-def-456",
  "project_name": "Frontend",
  "linked_at": "2026-01-15T10:30:00.000Z"
}

Consejo: Añade .contextforge a tu .gitignore si no quieres compartir el vínculo con tu equipo, o confírmalo con git si quieres que todos usen el mismo proyecto.

Referencia de herramientas MCP

memory_link_projectNuevo

Vincula el directorio actual a un Project de ContextForge.

Parámetros

NombreTipoObligatorioDescripción
project_namestringNoNombre del proyecto a vincular. Muestra una lista si no se indica.
create_newbooleanNoSi es true, crea un nuevo proyecto con el nombre indicado.

# Respuesta de ejemplo

{
  "success": true,
  "linked": true,
  "project": {
    "id": "abc-123",
    "name": "Frontend",
    "slug": "frontend"
  },
  "config_file": "/Users/you/project/.contextforge",
  "message": "Project \"Frontend\" linked to this directory",
  "hint": "Queries will now be filtered to this project's spaces"
}
memory_current_projectNuevo

Muestra el proyecto vinculado actualmente y sus Spaces.

# Respuesta de ejemplo

{
  "linked": true,
  "project": {
    "id": "abc-123",
    "name": "Frontend",
    "slug": "frontend",
    "space_count": 3
  },
  "spaces": [
    { "id": "...", "name": "Components", "slug": "components" },
    { "id": "...", "name": "State", "slug": "state" },
    { "id": "...", "name": "UI Guidelines", "slug": "ui-guidelines" }
  ],
  "config_file": "/Users/you/project/.contextforge",
  "message": "This directory is linked to project \"Frontend\" with 3 space(s)"
}
memory_unlink_projectNuevo

Elimina el vínculo de proyecto de este directorio. Borra el archivo .contextforge.

# Respuesta de ejemplo

{
  "success": true,
  "config_file": "/Users/you/project/.contextforge",
  "message": "Project unlinked from this directory",
  "hint": "Queries will now search all your spaces"
}

Cómo funciona el filtrado

Cuando hay un proyecto vinculado, las siguientes operaciones filtran automáticamente hacia los Spaces del proyecto:

HerramientaComportamiento con vínculo activo
memory_list_spacesSolo muestra los Spaces del proyecto vinculado
memory_queryBusca únicamente dentro de los Spaces del proyecto vinculado
memory_create_spaceCrea nuevos Spaces dentro del proyecto vinculado
memory_ingestGuarda en Spaces dentro del proyecto vinculado

Nota: Siempre puedes anular el filtrado automático especificando explícitamente un parámetro space_id o project_id.

Buenas prácticas

  • 1

    Vincula en la raíz del proyecto

    Crea el archivo .contextforge en el directorio raíz de tu proyecto, no en subdirectorios.

  • 2

    Un proyecto por codebase

    Cada repositorio de código local debe vincularse a un único Project de ContextForge.

  • 3

    Usa el mismo nombre

    Usa el mismo nombre para tu Project de ContextForge y tu repositorio para mayor claridad.

  • 4

    Úsalo con monorepos

    En un monorepo puedes vincular la raíz a un proyecto con múltiples Spaces (uno por paquete).